Model Context Protocol (MCP) Implementation

Model Context Protocol（MCP）の実装

このプロジェクトは、AI ツールを構築するための Model Context Protocol（MCP） を実装しています。MCP 互換のサーバーやクライアントを作成するために使用できる、モジュール式のフレームワークを提供します。

---

🔍 Model Context Protocol（MCP）とは？

Model Context Protocol（MCP）は、AI アシスタントが外部のツールやデータソースとやり取りできるようにするオープンプロトコルです。

主な機能

• 利用可能なツールとその機能を一覧表示する
• パラメーターを指定してツールを呼び出す
• 一貫した方法でエラーを処理する
• 標準化された形式でツールの結果を処理する

📚 詳細については、MCP Notes をご覧ください。

---

✨ 機能

カテゴリー	機能
コア	✅ JSON-RPC 2.0 メッセージ処理 ✅ プロトコルの初期化 ✅ ケイパビリティのネゴシエーション
ツール	✅ JSON Schema によるツールの登録 ✅ ツールの呼び出しと検証 ✅ 標準化されたエラー処理
トランスポート	✅ STDIO のサポート ✅ HTTP+SSE のサポート
テスト	✅ テスト用クライアント

---

📁 プロジェクト構成

src/
├── core/           # Core MCP server implementation
├── transports/     # Transport layer implementations (stdio, HTTP+SSE)
├── tools/          # Tool definitions and handlers
├── examples/       # Example servers and clients
│   └── public/     # Static files for HTTP server
└── index.js        # Main entry point for the library

---

🚀 はじめに

前提条件

• Node.js 20.x 以降
• npm または pnpm

インストール

# Clone the repository
git clone https://github.com/AshikNesin/learn-mcp-by-building
cd learn-mcp-by-building

# Install dependencies
npm install
# or
pnpm install

---

🏃‍♂️ サンプルの実行

STDIO サーバーとクライアント

STDIO サーバーを実行します：

npm run server:stdio
# or
node src/examples/stdio-server.js

STDIO クライアントでテストします：

npm run client:stdio
# or
node src/examples/stdio-client.js

両方を一緒に実行して、一連のテストを確認します：

npm run test:stdio
# or
node src/examples/stdio-client.js | node src/examples/stdio-server.js

HTTP+SSE サーバーとクライアント

HTTP+SSE サーバーを実行します：

npm run server:sse
# or
node src/examples/http-sse-server.js --port 5000

利用可能なオプション：

• --port：リッスンするポート（デフォルト：5000）
• --host：バインドするホスト（デフォルト：localhost）
• --path：エンドポイントのパス（デフォルト：/sse）
• --cors：CORS を有効にする（デフォルト：true）
• --serve-static：src/examples/public から静的ファイルを配信する（デフォルト：true）

HTTP+SSE クライアントでテストします：

npm run client:sse
# or
node src/examples/http-sse-client.js --server http://localhost:5000/sse

起動すると、ブラウザーで http://localhost:5000 にアクセスして、ウェブベースのクライアントインターフェースを利用することもできます：

このインターフェースでは、使いやすい方法で MCP サーバーとやり取りできます。電卓のコントロールとリアルタイムログが横並びに表示されます。

🔍 MCP Inspector の使用

公式の MCP Inspector を使って、サーバーをデバッグできます：

npm run debug

MCP Inspector は、MCP サーバーの監視とデバッグを行うためのビジュアルインターフェースを提供します：

---

🧮 電卓ツール

操作 ➕ 加算 ➖ 減算 ✖️ 乗算 ➗ 除算

パラメーター operation - 操作の種類 a - 第 1 オペランド b - 第 2 オペランド

エラー処理 ゼロ除算 無効な操作 型の検証 パラメーターの不足

---

🧑‍💻 MCP フレームワークでの開発

新しいサーバーの作成

import { McpServer } from '../core/index.js';
import { StdioTransport } from '../transports/index.js';
import { calculatorToolDefinition, handleCalculatorTool } from '../tools/index.js';

// Create server instance
const server = new McpServer(
  { name: 'my-server', version: '1.0.0' },
  { capabilities: { tools: { listChanged: true } } }
);

// Register tool handlers
server.setRequestHandler('tools/list', () => ({ tools: [calculatorToolDefinition] }));
server.setRequestHandler('tools/call', async (params) => {
  if (params.name === 'calculator') {
    return handleCalculatorTool(params.arguments);
  }
  throw new Error(`Tool ${params.name} not found`);
});

// Start the server
const transport = new StdioTransport();
server.connect(transport)
  .then(() => console.error('Server ready!'));

新しいツールの作成

1. src/tools/ に新しいファイルを作成します：

// src/tools/my-tool.js
export const myToolDefinition = {
  name: 'my-tool',
  description: 'Description of my tool',
  inputSchema: {
    type: 'object',
    properties: {
      // Define parameters
    },
    required: []
  }
};

export async function handleMyTool(args) {
  // Implement tool logic
  return {
    content: [
      {
        type: 'text',
        text: 'Result from my tool'
      }
    ]
  };
}

2. src/tools/index.js でツールをエクスポートします：

export * from './my-tool.js';

---

🛠️ プロトコルの機能

• ✅ ケイパビリティのネゴシエーション
• ✅ ツールリストの変更通知
• ✅ 標準化されたエラー処理
• ✅ JSON Schema による検証
• ✅ 構造化されたツールの結果
• ✅ トランスポート層の抽象化

---

📚 外部リソース

• MCP プロトコル仕様
• JSON-RPC 2.0 仕様
• MCP GitHub リポジトリ

---

📝 ライセンス

MIT