Skills: カスタムツール開発

MCP アーキテクチャ
┌──────────┐    MCP プロトコル    ┌──────────────┐
│ AI クライアント │ ←──────────────→ │ MCP サーバー   │
│ (Claude)  │                    │ (カスタムツール) │
└──────────┘                    └──────────────┘
                                      ↕
                               ┌──────────────┐
                               │ 外部サービス   │
                               │ (DB/API/File) │
                               └──────────────┘

カスタムツール開発フロー
1. 組み込みツールでは満たせないニーズを特定
2. ツールの入出力を定義
3. 実装言語を選択（Node.js / Python）
4. ツールロジックを実装
5. MCP サーバーを設定
6. Skill にバインドして使用

// mcp-server-example/index.ts
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new McpServer({ name: "db-query", version: "1.0.0" });

server.tool("query_database", { sql: { type: "string" } }, async ({ sql }) => {
  const result = await executeQuery(sql);
  return { content: [{ type: "text", text: JSON.stringify(result) }] };
});

const transport = new StdioServerTransport();
await server.connect(transport);

{
  "mcpServers": {
    "db-query": {
      "command": "node",
      "args": ["./mcp-servers/db-query/index.js"],
      "env": {
        "DATABASE_URL": "postgresql://localhost/mydb"
      }
    }
  }
}

server.tool("query_database", {
  sql: {
    type: "string",
    description: "SQL クエリ文（SELECT のみ）",
    validate: (sql: string) => {
      if (/^\s*(DROP|DELETE|UPDATE|INSERT|ALTER)/i.test(sql)) {
        throw new Error("SELECT クエリのみ許可されています");
      }
    }
  }
}, handler);

async ({ sql }) => {
  try {
    const result = await executeQuery(sql);
    return { content: [{ type: "text", text: JSON.stringify(result) }] };
  } catch (error) {
    return {
      content: [{ type: "text", text: `クエリ失敗：${error.message}` }],
      isError: true
    };
  }
};

# MCP サーバーを直接実行してテスト
node ./mcp-servers/db-query/index.js

# テストリクエストを送信
echo '{"method":"tools/list"}' | node ./mcp-servers/db-query/index.js

// ロギングミドルウェアを追加
server.tool("query_database", { sql: { type: "string" } }, async ({ sql }) => {
  console.error(`[DB-QUERY] SQL: ${sql}`);
  const start = Date.now();
  const result = await executeQuery(sql);
  console.error(`[DB-QUERY] Duration: ${Date.now() - start}ms`);
  return { content: [{ type: "text", text: JSON.stringify(result) }] };
});

公開方式
├── npm パッケージ：npm publish @your-org/mcp-server-xxx
├── Docker：docker build + docker push
├── Git リポジトリ：直接クローンして使用
└── 設定テンプレート：JSON 設定テンプレートを提供

---
name: log-analyzer
description: "ログ分析：検索、フィルタリング、統計"
tools:
  - Read
  - search_logs  # カスタム MCP ツール
---