MCP MateusData Server

MCP MateusData サーバー

シンプルな**Model Context Protocol（MCP）**を実装した TypeScript サーバーです。MCP サーバーの仕組みを理解するための、本格的な「Hello World」サンプルです。このプロジェクトには、次のような基本機能が含まれています。

• JSON-RPC リクエストの処理
• add-number や greet などのツールのサンプル
• リアルタイム通信のための Server-Sent Events（SSE）のサポート
• テストや学習を簡単にするためのシンプルなクライアントおよびサーバーコード

前提条件

• Node.js（v20 以降）
• npm（Node.js に付属）
• Cursor IDE（推奨）

インストール

1. リポジトリをクローンします。

git clone [email protected]:mateusdata/mcp-mateusdata-server.git
cd mcp-mateusdata-server

2. 依存関係をインストールします。

npm install

プロジェクトの実行

開発モード：

npm run dev

ビルドおよび本番環境での実行：

npm run build
npm start

Cursor への MCP サーバーの追加

Cursor の設定ファイルに、次の内容を追加します。

{
  "mcpServers": {    
  "mateusdata-mcp-server": {
   "command": "node",      
   "args": ["path/to/mcp-mateusdata-server/build/index.js"]
  }
  }
}

プロジェクト構成

mcp-mateusdata-server/
├── build/         # Compiled JavaScript files
├── src/           # Source code
    └── server.ts  # Simple MCP server example
│   └── client.js  # Simple MCP client example
├── node_modules/  # Project dependencies
├── package.json   # Project configuration and dependencies
└── tsconfig.json  # TypeScript configuration

概要

このリポジトリでは、Model Context Protocol（MCP）の最小限の実装を紹介します。src/client.js ファイルには、クライアントがサーバーとやり取りする方法の例が含まれており、テストや初めて学ぶ際に役立ちます。

使用例

Bash、Zsh、または Fish を使って、ターミナルから MCP サーバーと直接やり取りできます。たとえば、利用可能なツールを一覧表示するには、次のようにします。

値 a = 3 と b = 5 を指定して、ツール "add-number" を呼び出すには、次のようにします。

echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"add-number","arguments":{"a":3,"b":5}}}' | node build/index.js

パラメーター nome = "Mateus" を指定して、ツール "greet" を呼び出すには、次のようにします。

echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"greet","arguments":{"name":"Mateus"}}}' | node build/index.js

MCP サーバーでの SSE（Server-Sent Events）の使用

SSE を使ってリアルタイムに通信し、MCP サーバーとやり取りできます。サーバーを起動します。

node build/index.js sse

次のように表示されます。

MCP Server running with SSE on http://localhost:8765/sse

SSE エンドポイントへの接続

新しいターミナルで、curl を使って接続します。

curl http://localhost:8765/sse

出力例：

event: endpoint
data: /messages?sessionId=d9bfe7df-937c-475e-8d80-904a99f9ef4d

サーバーへのメッセージの送信

前の出力から sessionId をコピーし、それを使ってリクエストを送信します。

curl -X POST http://localhost:8765/messages \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"greet","arguments":{"name":"Mateus"}}}'

サーバーはリクエストの結果を SSE 接続経由で返します。

このプロジェクトは MIT License のもとでライセンスされています。