MCPサーバーでClaude Codeを拡張する ― 外部ツール連携ガイド

┌─────────────┐    JSON-RPC    ┌──────────────────┐
│  Claude Code │ ◄────────────► │  MCPサーバー      │
│ (MCPクライアント)│              │  (ツール提供側)    │
└─────────────┘               └──────────────────┘
                                       │
                                       ▼
                              ┌──────────────────┐
                              │  外部サービス      │
                              │  DB / API / FS    │
                              └──────────────────┘

{
  "mcpServers": {
    "サーバー名": {
      "command": "実行コマンド",
      "args": ["引数1", "引数2"],
      "env": {
        "環境変数名": "値"
      }
    }
  }
}

用途：高度なファイル操作

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
    }
  }
}

提供されるツール：ファイル検索、ディレクトリ一覧、ファイル移動、メタデータ取得など。Claude Codeの組み込みファイル操作よりも高度な操作が可能です。

用途：GitHub操作の自動化

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    }
  }
}

提供されるツール：リポジトリ操作、Issue作成・管理、Pull Request作成・レビュー、コミット履歴の取得など。

用途：データベースの直接操作

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-sqlite", "--db-path", "./db/myapp.db"]
    }
  }
}

提供されるツール：SQLクエリ実行、テーブル一覧、スキーマ確認、データ挿入・更新・削除。AIがSQLを生成して直接実行できます。

用途：Web検索

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your-api-key"
      }
    }
  }
}

提供されるツール：Web検索、ニュース検索。AIがリアルタイムの情報を検索して回答に反映できます。

用途：WebページやAPIの取得

{
  "mcpServers": {
    "fetch": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-fetch"]
    }
  }
}

提供されるツール：URLからのコンテンツ取得。APIドキュメントの取得、Webページの内容確認などに活用できます。

// my-mcp-server.js
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

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

// ツールの定義
server.setRequestHandler("tools/list", async () => ({
  tools: [
    {
      name: "check_website_status",
      description: "指定されたWebサイトのステータスコードを確認します",
      inputSchema: {
        type: "object",
        properties: {
          url: {
            type: "string",
            description: "確認するURL"
          }
        },
        required: ["url"]
      }
    }
  ]
}));

// ツールの実装
server.setRequestHandler("tools/call", async (request) => {
  if (request.params.name === "check_website_status") {
    const { url } = request.params.arguments;
    try {
      const response = await fetch(url);
      return {
        content: [{
          type: "text",
          text: `URL: ${url}\nStatus: ${response.status}\nOK: ${response.ok}`
        }]
      };
    } catch (error) {
      return {
        content: [{
          type: "text",
          text: `Error: ${error.message}`
        }],
        isError: true
      };
    }
  }
});

// サーバー起動
const transport = new StdioServerTransport();
await server.connect(transport);

APIキーの安全な管理

# 悪い例：設定ファイルにAPIキーを直接記述
{
  "env": {
    "API_KEY": "sk-xxxxxxxxxxxxx"  # 危険！
  }
}

# 良い例：環境変数を参照
{
  "env": {
    "API_KEY": "${MY_API_KEY}"  # 環境変数から取得
  }
}

# 環境変数の設定（.bashrc等）
export MY_API_KEY="sk-xxxxxxxxxxxxx"

SQLite MCPサーバーを使って、AIがデータベースの内容を確認しながらコードを書くワークフロー。

# Claude Codeでの会話例
> newsテーブルの構造を確認して、最新5件のニュースを
> 表示するPHP関数を書いてください

# AIが内部的にMCPツールを使って：
# 1. テーブルのスキーマを確認
# 2. 実際のデータを確認
# 3. データに合った適切なコードを生成

GitHub MCPサーバーを使って、Issue管理からPR作成までをAIが一貫して行うワークフロー。

# Claude Codeでの会話例
> Issue #42のバグを修正して、修正内容のPRを作成してください

# AIが内部的に：
# 1. GitHub MCPでIssue #42の内容を取得
# 2. バグの原因を調査・修正
# 3. コミットを作成
# 4. GitHub MCPでPRを作成（Issue #42への参照を含む）

Fetch MCPサーバーを使って、最新のAPIドキュメントを参照しながら連携コードを書くワークフロー。

# Claude Codeでの会話例
> Stripe APIの最新ドキュメントを確認して、
> 決済処理の実装を更新してください

# AIが内部的に：
# 1. Fetch MCPでStripeのAPIドキュメントを取得
# 2. 最新の仕様を確認
# 3. 既存コードを最新仕様に合わせて更新