Chapter 34: MCP サーバー連携

# 1. ファイルシステム MCP サーバー（ローカルファイル操作）
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/workspace

# 2. GitHub MCP サーバー
claude mcp add github -- npx -y @modelcontextprotocol/server-github

# 3. Brave Search MCP サーバー
claude mcp add brave-search -- npx -y @modelcontextprotocol/server-brave-search

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

# Slack Bot Token を環境変数に設定
export SLACK_BOT_TOKEN="xoxb-..."
export SLACK_TEAM_ID="T..."

claude mcp add slack -- npx -y @modelcontextprotocol/server-slack

Claude Code に指示する例:

「feature/auth ブランチの PR をマージして、
 完了したら #dev-updates チャンネルに
 "✅ auth 機能をリリースしました。変更点: [変更概要]" を投稿してください」

# 環境変数の設定
export GITHUB_PERSONAL_ACCESS_TOKEN="ghp_..."

claude mcp add github -- npx -y @modelcontextprotocol/server-github

# Issue の自動トリアージ
「未対応の Issue を全て読んで、優先度（Critical/High/Medium/Low）を
 ラベルで付けてください。基準: セキュリティ > データ破損 > 機能バグ > 改善」

# PR 自動レビュー
「今週オープンされた PR を全て確認して、
 テストが不足しているものに review request コメントを残してください」

claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres \
  "postgresql://user:password@localhost:5432/mydb"

# スロークエリの自動調査
「過去1週間のスロークエリログを分析して、
 インデックスの追加で改善できるクエリをリストアップしてください。
 改善案の SQL も合わせて提案してください」

# claude_desktop_config.json または mcp_settings.json
{
  "mcpServers": {
    "figma": {
      "command": "npx",
      "args": ["-y", "@figma/mcp-server-figma"],
      "env": {
        "FIGMA_API_KEY": "${FIGMA_API_KEY}"
      }
    }
  }
}

Figma URL: https://figma.com/design/abc123/MyApp?node-id=1-2

「このノード（node-id: 1-2）をTailwind CSSを使ったReact コンポーネントに変換してください。
 - TypeScript 使用
 - Props は適切に型定義する
 - アクセシビリティ属性を付与する」

// my-company-mcp/src/index.ts
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import {
  CallToolRequestSchema,
  ListToolsRequestSchema,
} from "@modelcontextprotocol/sdk/types.js";

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

// ツールの定義
server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [
    {
      name: "get_deployment_status",
      description: "サービスのデプロイ状態を取得する",
      inputSchema: {
        type: "object",
        properties: {
          service: {
            type: "string",
            description: "サービス名（例: api, web, worker）",
          },
          environment: {
            type: "string",
            enum: ["staging", "production"],
          },
        },
        required: ["service", "environment"],
      },
    },
  ],
}));

// ツールの実装
server.setRequestHandler(CallToolRequestSchema, async (request) => {
  if (request.params.name === "get_deployment_status") {
    const { service, environment } = request.params.arguments as {
      service: string;
      environment: string;
    };

    // 社内 API を呼び出す
    const response = await fetch(
      `https://deploy.internal.example.com/api/status/${environment}/${service}`
    );
    const data = await response.json();

    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(data, null, 2),
        },
      ],
    };
  }

  throw new Error(`Unknown tool: ${request.params.name}`);
});

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

# ビルド
cd my-company-mcp && npm run build

# 登録
claude mcp add my-company -- node /path/to/my-company-mcp/dist/index.js

# 動作確認
claude mcp list
# → my-company: node /path/to/my-company-mcp/dist/index.js ✓