MCPサーバー構築支援スキル

概要

MCP（Model Context Protocol）サーバーの設計・構築を支援するスキルです。日本で広く使われるビジネスAPIとの連携を中心に、プロジェクト構成からツール定義までをカバーします。

MCPサーバーの基本構成

MCPサーバーは、LLMが外部ツール・データソースにアクセスするための標準プロトコルです。

クライアント (Claude等) ←→ MCPサーバー ←→ 外部API / データベース

主要な構成要素

日本のAPI連携例

Chatwork API

// チャットワークへのメッセージ送信ツール
server.tool("chatwork_send_message", {
  room_id: z.string().describe("ルームID"),
  body: z.string().describe("メッセージ本文"),
}, async ({ room_id, body }) => {
  const res = await fetch(
    `https://api.chatwork.com/v2/rooms/${room_id}/messages`,
    { method: "POST", headers: { "X-ChatWorkToken": TOKEN },
      body: new URLSearchParams({ body }) }
  );
  return { content: [{ type: "text", text: `送信完了: ${res.status}` }] };
});

Backlog API

• 課題の作成・更新・検索
• Wiki ページの取得・編集
• プロジェクト情報の参照

freee会計 API

• 取引の登録・検索
• 勘定科目の取得
• 請求書の作成

kintone API

• レコードの取得・登録・更新
• アプリ情報の参照
• フィールド定義の取得

プロジェクト構成テンプレート

my-mcp-server/
├── src/
│   ├── index.ts          # エントリポイント（サーバー起動）
│   ├── tools/            # ツール定義
│   │   ├── chatwork.ts   # Chatwork 連携ツール
│   │   └── backlog.ts    # Backlog 連携ツール
│   ├── resources/        # リソース定義
│   └── utils/            # ユーティリティ関数
├── package.json
├── tsconfig.json
└── README.md             # 日本語ドキュメント

基本的なサーバー初期化

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

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

// ツールの登録
// server.tool(...) でツールを追加

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

開発ルール

コメント・ドキュメントは日本語で記述

/**
 * Chatworkの指定ルームにメッセージを送信する
 * @param roomId - 送信先のルームID
 * @param message - 送信するメッセージ本文
 * @returns 送信結果のステータス
 */

ツール説明文の日本語化

• describe() の引数は日本語で記述する
• LLMがツールの用途を正しく理解できるよう、具体的に記述する

エラーメッセージの日本語化

• API エラーは日本語で分かりやすく返す
• 例: "Chatworkへの送信に失敗しました（ステータス: 401 認証エラー）"

参考リンク

• MCP仕様書
• MCP TypeScript SDK
• MCPサーバー一覧