MCPサーバー自作 調査・計画¶

┌─────────────────────────────────────────┐
│          MCP Host（AIアプリケーション）         │
│  例: Claude Code, Claude Desktop, VS Code │
│                                         │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐ │
│  │MCP Client│  │MCP Client│  │MCP Client│ │
│  │    #1    │  │    #2    │  │    #3    │ │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘ │
└───────┼──────────────┼──────────────┼──────┘
        │              │              │
  ┌─────▼─────┐  ┌─────▼─────┐  ┌─────▼─────┐
  │MCP Server │  │MCP Server │  │MCP Server │
  │(ローカル)  │  │(ローカル)  │  │(リモート)  │
  │ Filesystem│  │  MyLab    │  │  Sentry   │
  └───────────┘  └───────────┘  └───────────┘

"""
最小構成のMCPサーバー例
pip install "mcp[cli]" でインストール
"""
from mcp.server.fastmcp import FastMCP

# サーバーインスタンス作成
mcp = FastMCP("my-server")


# === Tool（LLMが実行するアクション）===
@mcp.tool()
def greet(name: str) -> str:
    """指定された名前に挨拶する"""
    return f"こんにちは、{name}さん！"


@mcp.tool()
def add(a: int, b: int) -> int:
    """2つの数値を加算する"""
    return a + b


# === Resource（読み取り専用データ）===
@mcp.resource("info://server")
def server_info() -> str:
    """サーバー情報を返す"""
    return "これはMyLabのテスト用MCPサーバーです。"


@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """パーソナライズされた挨拶"""
    return f"ようこそ、{name}さん！"


# === Prompt（再利用テンプレート）===
@mcp.prompt()
def code_review(language: str = "python") -> str:
    """コードレビュー用のプロンプトテンプレート"""
    return f"以下の{language}コードをレビューしてください。バグ、改善点、ベストプラクティスの観点でフィードバックしてください。"


# エントリーポイント
if __name__ == "__main__":
    mcp.run()  # デフォルトはstdio

# stdioサーバーの登録
claude mcp add --transport stdio mylab -- python D:/Kazuma_Teramachi/MyLab/projects/mcp-server-mylab/server.py

# スコープ指定（ローカル=デフォルト / プロジェクト / ユーザー）
claude mcp add --transport stdio --scope user mylab -- python server.py

# HTTPサーバーの登録
claude mcp add --transport http my-server http://localhost:8000/mcp

# 環境変数付き
claude mcp add --transport stdio --env API_KEY=xxx myserver -- python server.py

{
  "mcpServers": {
    "mylab": {
      "command": "python",
      "args": ["projects/mcp-server-mylab/server.py"]
    }
  }
}

claude mcp add-json mylab '{"type":"stdio","command":"python","args":["projects/mcp-server-mylab/server.py"]}'

claude mcp list          # 一覧
claude mcp get mylab     # 詳細
claude mcp remove mylab  # 削除

claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package

# インストール不要、npxで起動
npx -y @modelcontextprotocol/inspector

# ブラウザが開く → サーバーURLを入力して接続
# stdioサーバー: コマンドを指定して起動
# HTTPサーバー: http://localhost:8000/mcp を入力

from mcp.server.fastmcp import FastMCP, Context
from mcp.server.session import ServerSession
import logging

logging.basicConfig(level=logging.DEBUG)

mcp = FastMCP("debug-server")

@mcp.tool()
async def debug_tool(message: str, ctx: Context[ServerSession, None]) -> str:
    """デバッグ用ツール"""
    await ctx.info(f"実行中: {message}")  # クライアントにログ送信
    return f"OK: {message}"

# Claude Code上で /mcp コマンドを実行してサーバーの状態を確認
/mcp

# ディレクトリ作成
mkdir -p projects/mcp-server-obsidian

# 依存パッケージ
pip install "mcp[cli]"

projects/mcp-server-obsidian/
├── server.py      # MCPサーバー本体
├── README.md      # 使い方
└── tests/
    └── test_server.py

from mcp.server.fastmcp import FastMCP
from pathlib import Path
import re

VAULT_ROOT = Path("D:/Kazuma_Teramachi/MyLab/vault")

mcp = FastMCP("obsidian-vault")

@mcp.tool()
def search_notes(query: str, limit: int = 20) -> str:
    """Vault内のノートをキーワード検索する"""
    results = []
    for md in VAULT_ROOT.rglob("*.md"):
        try:
            content = md.read_text(encoding="utf-8", errors="ignore")
            if query.lower() in content.lower() or query.lower() in md.stem.lower():
                # タイトル（最初のH1または ファイル名）
                title = md.stem
                for line in content.splitlines():
                    if line.startswith("# "):
                        title = line[2:].strip()
                        break
                rel = md.relative_to(VAULT_ROOT)
                results.append(f"- **{title}** (`{rel}`)")
                if len(results) >= limit:
                    break
        except Exception:
            continue
    if not results:
        return f"'{query}' に一致するノートが見つかりませんでした。"
    return f"## 検索結果: '{query}' ({len(results)}件)\n\n" + "\n".join(results)

@mcp.tool()
def read_note(path: str) -> str:
    """指定パスのノートを読み取る（Vaultルートからの相対パス）"""
    note = VAULT_ROOT / path
    if not note.exists():
        return f"ノートが見つかりません: {path}"
    return note.read_text(encoding="utf-8", errors="ignore")

@mcp.tool()
def create_note(path: str, content: str) -> str:
    """新しいノートを作成する"""
    note = VAULT_ROOT / path
    if note.exists():
        return f"既にノートが存在します: {path}"
    note.parent.mkdir(parents=True, exist_ok=True)
    note.write_text(content, encoding="utf-8")
    return f"ノートを作成しました: {path}"

@mcp.tool()
def list_recent_notes(limit: int = 10) -> str:
    """最近更新されたノートを一覧する"""
    notes = sorted(
        VAULT_ROOT.rglob("*.md"),
        key=lambda p: p.stat().st_mtime,
        reverse=True,
    )[:limit]
    lines = [f"## 最近更新されたノート（{len(notes)}件）\n"]
    for n in notes:
        rel = n.relative_to(VAULT_ROOT)
        lines.append(f"- `{rel}`")
    return "\n".join(lines)

if __name__ == "__main__":
    mcp.run()

@mcp.resource("vault://structure")
def vault_structure() -> str:
    """Vaultのフォルダ構造を返す"""
    # トップレベルのフォルダ一覧
    ...

@mcp.resource("vault://daily/{date}")
def daily_note(date: str) -> str:
    """デイリーノートを返す（例: 2026-03-13）"""
    ...

@mcp.prompt()
def new_note_template(topic: str) -> str:
    """新しいノートのテンプレートプロンプト"""
    return f"「{topic}」について以下の構成でノートを作成してください:\n- 概要\n- キーポイント\n- 参考リンク\n- 次のアクション"

# MCP Inspectorで動作確認
npx -y @modelcontextprotocol/inspector

# Claude Codeに登録
claude mcp add --transport stdio obsidian-vault -- python D:/Kazuma_Teramachi/MyLab/projects/mcp-server-obsidian/server.py

# 動作確認
claude mcp list
# Claude Code内で /mcp → 状態確認