MCP Servers — 外部世界とつながる

Claude Codeは、ローカルのファイルシステムとWebだけで動作するわけではない。MCPを通じて、GitHub、データベース、外部API、あらゆるサービスと連携できる。

MCPとは何か

MCP（Model Context Protocol） は、AIモデルと外部ツール・データソースを接続するためのオープンプロトコルだ。Anthropicが策定し、オープンスタンダードとして公開している。

簡単に言えば、MCPは「AIにプラグインを追加する仕組み」である。

Claude Codeは標準でファイル操作やBash実行ができるが、MCPサーバーを追加することで、以下のような機能を得られる。

• GitHub: Issue、PR、リポジトリ操作を認証付きで実行
• データベース: PostgreSQL、MySQL等へのクエリ実行
• Slack: メッセージの送受信
• Google Drive: ドキュメントの読み書き
• カスタムAPI: 任意のREST/GraphQL APIとの連携

MCPの仕組み

Claude Code ←→ MCP Client ←→ MCP Server ←→ 外部サービス

1. Claude Codeが「GitHubのIssue一覧を取得したい」と判断する
2. MCP ClientがMCP Serverにリクエストを送信する
3. MCP ServerがGitHub APIを呼び出す
4. 結果がClaude Codeに返される

この仕組みにより、Claude Code自体を改造することなく、新しいサービスとの連携を追加できる。

MCPサーバーの設定

settings.jsonにMCPサーバーの設定を追加する。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxx"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
    }
  }
}

設定のポイント

• command: MCPサーバーの起動コマンド
• args: コマンドの引数
• env: 環境変数（APIトークン等）

よく使うMCPサーバー

GitHub MCP Server

GitHubのIssue、PR、リポジトリを直接操作できる。

> このリポジトリのオープンなIssueを一覧表示して
> Issue #42 にコメントを追加して
> PRのレビューコメントを取得して

Filesystem MCP Server

追加のファイルシステムアクセスを提供する。特定のディレクトリへのアクセスを安全に制限できる。

Database MCP Server

PostgreSQLやMySQLに直接クエリを実行できる。

> patientsテーブルから年齢が10歳未満のレコードを取得して

MCPのセキュリティ

MCPは強力だが、セキュリティ上の考慮が必要だ。

最小権限

MCPサーバーに渡すトークンの権限は最小限にする。GitHubトークンなら、必要なリポジトリとスコープだけに限定する。

アクセス制限

Filesystem MCPサーバーでは、アクセスを許可するディレクトリを明示的に指定する。ルートディレクトリや機密ファイルを含むディレクトリへのアクセスは与えない。

監査

MCPサーバー経由のすべての操作は、Claude Codeのパーミッションシステムを通過する。不審な操作は確認ダイアログで阻止できる。

カスタムMCPサーバーの構築

既存のMCPサーバーでは対応できないサービスとの連携が必要な場合、カスタムMCPサーバーを構築できる。

基本構造

import { Server } from "@modelcontextprotocol/sdk/server";

const server = new Server({
  name: "my-custom-server",
  version: "1.0.0"
});

// ツール定義
server.setRequestHandler("tools/list", async () => ({
  tools: [{
    name: "get_patient_count",
    description: "患者数を取得する",
    inputSchema: {
      type: "object",
      properties: {
        department: { type: "string" }
      }
    }
  }]
}));

// ツール実行
server.setRequestHandler("tools/call", async (request) => {
  if (request.params.name === "get_patient_count") {
    // 実際のAPI呼び出し
    return { content: [{ type: "text", text: "42" }] };
  }
});

医療現場での応用例

• 電子カルテAPI連携: 患者データの読み取り（読み取り専用で安全に）
• DICOM画像サーバー: 医用画像の検索と表示
• 薬剤データベース: 薬剤情報の検索と相互作用チェック
• ガイドラインデータベース: 最新の診療ガイドラインの検索

MCPの未来

MCPはオープンスタンダードとして急速に成長している。

• エコシステムの拡大: 新しいMCPサーバーが日々公開されている
• 標準化: 他のAIプラットフォームもMCPを採用し始めている
• セキュリティ強化: 認証・認可の標準化が進行中

MCPを理解しておくことは、Claude Codeだけでなく、AI開発全般の未来を見据える上で重要な投資だ。