Example MCP

🚀 カーソルモデルコンテキストプロトコル (MCP) サンプル

このリポジトリには、カーソル IDE の機能を強化するために使用できるモデルコンテキストプロトコル (MCP) サーバーのサンプル実装が含まれています。

📚 モデルコンテキストプロトコルとは？

モデルコンテキストプロトコル (MCP) は、アプリケーションが大規模言語モデル (LLMs) にコンテキスト情報を提供する方法を標準化したオープンプロトコルです。これにより、カーソル内の AI アシスタントと一緒に使用して、人工知能機能を強化するカスタムツールを作成することができます。

MCP を、デバイスと周辺機器にとっての USB - C ポートのように考えてみてください。

• USB - C がデバイスをさまざまな周辺機器に接続する標準化された方法を提供するように、MCP は AI モデルをさまざまなデータソースやツールに接続する標準化された方法を提供します。
• これにより、AI アシスタントはリアルタイム情報にアクセスし、専用機能を実行し、トレーニングデータの限界を超えることができます。

📁 プロジェクト構造

example-mcp/
├── mcp-servers/                # 異なる MCP サーバーの実装
│   ├── task-manager/           # タスクマネージャー MCP サーバーのサンプル
│   ├── file-explorer/          # ファイルエクスプローラー MCP サーバーのサンプル
│   └── weather-service/        # 天気サービス MCP サーバーのサンプル
├── README.md                   # プロジェクトドキュメント
└── LICENSE                     # ライセンス情報

🚀 クイックスタート

📋 前提条件

• Node.js (バージョン >= 14)
• npm または yarn パッケージマネージャー
• カーソル IDE (バージョン >= 2023.12)

🛠️ MCP サーバーのセットアップ

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

git clone https://github.com/yourusername/example-mcp.git
cd example-mcp

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

npm install @modelcontextprotocol/server express

3. MCP サーバーを起動します：

node index.js

🔗 カーソルで MCP サーバーに接続する

1. カーソル IDE を開きます。
2. 右上の歯車アイコンをクリックし、設定メニューに移動します。
3. 「コンテキスト」 > 「モデルコンテキストプロトコル」を選択します。
4. 「サーバーを追加」をクリックし、以下の情報を入力します：
   • 名前：サンプル MCP サーバー
   • タイプ：HTTP
   • アドレス：http://localhost:3000
5. 「保存」をクリックします。

💻 使用例

タスクマネージャー

• 名前: task-manager
• 説明: タスクの作成、更新、削除を行います。
• パラメータスキーマ:

  {
    "type": "object",
    "properties": {
      "action": { "type": "string", "enum": ["create", "update", "delete"] },
      "task": {
        "type": "object",
        "properties": {
          "id": { "type": "integer" },
          "title": { "type": "string" },
          "description": { "type": "string" }
        }
      }
    }
  }
  

ファイルエクスプローラー

• 名前: file-explorer
• 説明: ファイルシステムを閲覧し、操作を実行します。
• パラメータスキーマ:

  {
    "type": "object",
    "properties": {
      "action": { "type": "string", "enum": ["list", "open"] },
      "path": { "type": "string" }
    }
  }
  

天気サービス

• 名前: weather-service
• 説明: 天気情報を取得します。
• パラメータスキーマ:

  {
    "type": "object",
    "properties": {
      "action": { "type": "string", "enum": ["get_weather"] },
      "location": { "type": "string" }
    }
  }
  

🔧 MCP アーキテクチャ

コンポーネント

• MCP ホスト: コンテキスト情報を提供するコンポーネントです。
• MCP クライアント: MCP サービスを呼び出すコンポーネントです。
• MCP サーバー: 具体的な機能を実装し、リクエストに応答するコンポーネントです。

伝送方式

Stdio

const { createServer } = require('@modelcontextprotocol/server');

createServer()
  .registerTool('task-manager', {
    name: 'Task Manager',
    description: 'Create, update and delete tasks.',
    paramsSchema: {
      type: 'object',
      properties: {
        action: { type: 'string', enum: ['create', 'update', 'delete'] },
        task: {
          type: 'object',
          properties: {
            id: { type: 'integer' },
            title: { type: 'string' },
            description: { type: 'string' }
          }
        }
      }
    }
  })
  .listen(3000, () => console.log('Server is running on port 3000'));

HTTP (SSE)

const express = require('express');
const { createServer } = require('@modelcontextprotocol/server');

const app = express();

createServer(app).registerTool('file-explorer', {
  name: 'File Explorer',
  description: 'Browse file system and perform operations.',
  paramsSchema: {
    type: 'object',
    properties: {
      action: { type: 'string', enum: ['list', 'open'] },
      path: { type: 'string' }
    }
  }
});

app.listen(3000, () => console.log('Server is running on port 3000'));

🌟 独自の MCP サーバーを作成する

1. プロジェクトを初期化します：

mkdir my-mcp-server && cd $_
npm init -y

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

npm install @modelcontextprotocol/server express

3. メインファイル index.js を作成します：

const express = require('express');
const { createServer } = require('@modelcontextprotocol/server');

const app = express();

createServer(app).registerTool('my-tool', {
  name: 'My Tool',
  description: 'Perform custom operations.',
  paramsSchema: {
    type: 'object',
    properties: {
      action: { type: 'string' },
      params: { type: 'object' }
    }
  }
});

app.listen(3000, () => console.log('Server is running on port 3000'));

4. サーバーを起動します：

node index.js

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。詳細については LICENSE ファイルを参照してください。

👥 貢献者

• [Your Name]