MCP Protocol スキル

概要

Model Context Protocol (MCP) は、AI システムが外部ツールやデータソースと標準化された方法で対話するためのプロトコル仕様です。このスキルは、MCP プロトコルの構造、設定方法、ベストプラクティスを提供します。

コアコンセプト

1. MCP アーキテクチャ

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   Claude AI     │────▶│   MCP Server    │────▶│  External Tool  │
│  (クライアント)  │◀────│   (プロキシ)     │◀────│  (API/Service)  │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                       │                       │
        │  MCP Protocol         │  Native Protocol      │
        │  (標準化)             │  (REST/GraphQL等)     │

2. MCP サーバー定義構造

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@mcp-server/package-name"],
      "env": {
        "API_KEY": "${API_KEY}"
      }
    }
  }
}

必須フィールド:

• command: 実行コマンド（npx, node, python 等）
• args: コマンド引数

オプションフィールド:

• env: 環境変数マッピング
• cwd: 作業ディレクトリ
• disabled: 無効化フラグ

3. 接続方式

4. ツール定義仕様

{
  "name": "tool_name",
  "description": "ツールの機能説明",
  "inputSchema": {
    "type": "object",
    "properties": {
      "param1": {
        "type": "string",
        "description": "パラメータ説明"
      }
    },
    "required": ["param1"]
  }
}

パラメータスキーマ設計

型定義

バリデーション制約

{
  "type": "string",
  "minLength": 1,
  "maxLength": 100,
  "pattern": "^[a-z]+$",
  "enum": ["option1", "option2"]
}

必須/任意パラメータ

{
  "properties": {
    "required_param": { "type": "string" },
    "optional_param": { "type": "string", "default": "default_value" }
  },
  "required": ["required_param"]
}

設計時の判断基準

MCP サーバー設計チェックリスト

• サーバー名は kebab-case 命名規則に従っているか？
• 接続方式（command/url）は適切に選択されているか？
• 環境変数は安全に管理されているか？
• タイムアウト設定は適切か？

ツール定義チェックリスト

• ツール名はリソース指向で一貫性があるか？
• 説明文は機能と用途を明確に表現しているか？
• パラメータスキーマは型安全か？
• 必須/任意の区別は適切か？
• デフォルト値は合理的か？

エラーハンドリング仕様

エラーコード体系

リトライ戦略

{
  "retry": {
    "maxAttempts": 3,
    "backoff": "exponential",
    "initialDelay": 1000,
    "maxDelay": 10000
  }
}

リソース参照

詳細な仕様とパターンについては以下を参照:

• 仕様詳細: cat .claude/skills/mcp-protocol/resources/mcp-specification.md
• 設定例: cat .claude/skills/mcp-protocol/resources/config-examples.md
• トラブルシューティング: cat .claude/skills/mcp-protocol/resources/troubleshooting.md

テンプレート参照

• サーバー設定テンプレート: cat .claude/skills/mcp-protocol/templates/server-config-template.json
• ツール定義テンプレート: cat .claude/skills/mcp-protocol/templates/tool-definition-template.json

スクリプト実行

# MCP設定ファイルの検証
node .claude/skills/mcp-protocol/scripts/validate-mcp-config.mjs <config.json>

# ツール定義スキーマ検証
node .claude/skills/mcp-protocol/scripts/validate-tool-schema.mjs <tool-def.json>

関連スキル