第7部:AIツールの拡張 Step 24 / 36

カスタムMCPサーバー作成

自社のAPIやデータベースをClaude Codeから操作できるよう、独自のMCPサーバーを作成します。

MCPサーバーの構造

# Python (mcp パッケージ使用)
from mcp.server import Server
from mcp.types import Tool

server = Server("my-custom-server")

@server.tool()
async def get_user_stats(user_id: str) -> dict:
    """ユーザーの統計情報を取得"""
    # 実装
    return {"user_id": user_id, "posts": 42}

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

AIにサーバー作成を依頼

AIへの指示

社内のユーザー管理APIをClaude Codeから操作できる
MCPサーバーを作成してください。

【機能】
- ユーザー検索 (search_users)
- ユーザー詳細取得 (get_user)
- ユーザー更新 (update_user)

【API仕様】
- Base URL: https://api.internal.example.com
- 認証: Bearer token
- GET /users?q={query}
- GET /users/{id}
- PATCH /users/{id}

設定と使用

設定追加

{
  "mcpServers": {
    "internal-api": {
      "command": "python",
      "args": ["./mcp-servers/internal-api/server.py"],
      "env": {
        "API_TOKEN": "xxx"
      }
    }
  }
}

まとめ

  • カスタムサーバー - 社内ツールをAIに接続
  • @server.tool() - 関数をツールとして公開
  • AIに作成依頼 - 仕様を伝えてサーバー生成
MCP入門 次へ:Claude Code Hooks