Simple MCP Server

シンプルな MCP サーバー

TypeScript と @modelcontextprotocol/sdk で構築された、基本的な MCP（Model Context Protocol）サーバーの例です。

このサーバーは、送信されたメッセージをそのまま返すシンプルな echo ツールを提供します。

機能

• TypeScript で構築
• @modelcontextprotocol/sdk を使用
• 基本的な echo ツールを搭載
• npm での公開用に設定済み
• stdio 経由で通信

前提条件

• Node.js（バージョン 16 以上を推奨）
• npm（通常は Node.js に付属）

インストール（開発者向け）

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

   git clone <repository-url>
   cd simple-mcp-server
   

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

   npm install
   

3. サーバーをビルドします：

   npm run build
   

サーバーをローカルで実行する

ビルド後、Node を使ってコンパイル済みのサーバーを直接実行できます：

node build/index.js

サーバーが起動し、標準入力／出力経由で MCP 通信を待ち受けます。ターミナルの標準エラー出力に「Simple MCP Server running on stdio」のようなメッセージが表示されます。

MCP クライアント（例：Claude Desktop）での使用

このサーバーを Claude for Desktop などの MCP クライアントで使用するには、このサーバーを起動するようにクライアントを設定する必要があります。

1. サーバーをビルドします： サーバーのプロジェクトディレクトリで npm run build を実行したことを確認します。

2. 絶対パスを確認します： コンパイル済みのエントリーポイントへの絶対パスを取得します。これはプロジェクトディレクトリ内の build/index.js です。

   • macOS/Linux では、build ディレクトリ内で pwd を使用するか、ルートディレクトリでの pwd の結果に /build/index.js を追加します。
   • Windows では、エクスプローラーで build ディレクトリに移動してパスをコピーするか、コマンドプロンプトで cd build を実行してから cd を実行します。

3. クライアントの設定を編集します： MCP クライアントの設定ファイル（例：Claude Desktop の claude_desktop_config.json）を開きます。

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

4. サーバーエントリーを追加します： mcpServers の下にサーバーのエントリーを追加します。/ABSOLUTE/PATH/TO/YOUR/PROJECT/simple-mcp-server を、手順 2 で確認した実際の絶対パスに置き換えます。

   {
     "mcpServers": {
       "simple-server": { // src/index.ts で定義された名前を使用します
         "command": "node",
         "args": [
           "/ABSOLUTE/PATH/TO/YOUR/PROJECT/simple-mcp-server/build/index.js"
         ]
       }
       // ... 他のサーバーがここに記載されている場合があります
     }
   }
   

5. クライアントを再起動します： 設定ファイルを保存し、MCP クライアントアプリケーションを再起動します。

これで、クライアントから「simple-server」とその echo ツールを確認して使用できるようになります。

npm への公開（任意）

1. package.json に正しい情報（名前、バージョン、作成者、リポジトリなど）が設定されていることを確認します。
2. npm にログインしていることを確認します（npm login）。
3. 公開コマンドを実行します：

   npm publish --access public # 公開パッケージには --access public を使用します
   

公開後、package.json の bin エントリーが設定されていれば、filesystem の例と同様に、ユーザーは npx を使って実行できる可能性があります。

開発

• ビルド： npm run build（TypeScript を build/ 内の JavaScript にコンパイルします）
• 監視： npm run build -- --watch（変更を継続的に監視し、再コンパイルします）