Contextual MCP Server

🚀 コンテキストMCPサーバー

このサーバーは、Contextual AIを使用したModel Context Protocol（MCP）サーバーで、検索強化生成（RAG）機能を提供します。複数のMCPクライアントと統合可能で、このドキュメントではCursor IDEとClaude Desktopとの統合方法を紹介します。

🚀 クイックスタート

このMCPサーバーは、Cursor IDEやClaude DesktopなどのAIインターフェースと、専用のContextual AIエージェントの間の橋渡し役を果たします。以下に、その機能や統合方法を説明します。

✨ 主な機能

概要

このMCPサーバーは、AIインターフェース（Cursor IDEやClaude Desktopなど）と専用のContextual AIエージェントの間の橋渡し役を果たします。以下の機能を実現します。

1. クエリ処理：特定分野の質問を専用のContextual AIエージェントに直接送信します。
2. スマート検索：包括的な情報を基に、知識ベース内を検索します。
3. コンテキスト感知応答：生成される回答は以下の特徴を持ちます。

• ソースドキュメントに基づいています。
• 引用と出典を含みます。
• 会話のコンテキストを維持します。

統合フロー

Cursor/Claude Desktop → MCP Server → Contextual AI RAG Agent
        ↑                  ↓             ↓                         
        └──────────────────┴─────────────┴───────────────引用付きの応答

📦 インストール

前提条件

• Python 3.10以上
• Cursor IDEおよび/またはClaude Desktop
• Contextual AI APIキー
• MCP互換環境

インストール手順

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

git clone https://github.com/ContextualAI/contextual-mcp-server.git
cd contextual-mcp-server

2. 仮想環境を作成してアクティブ化します。

python -m venv .venv
source .venv/bin/activate  # Windowsでは`.venv\Scripts\activate`を使用

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

pip install -r requirements.txt

📚 ドキュメント

設定

サーバーの設定を変更するには、以下の手順を実行します。

1. config.pyに以下の内容を追加または変更します。

# 設定例
API_KEY = "your_api_key"
AGENT_ID = "your_agent_id"

2. .envファイルを使用してAPIキーとAGENT_IDを保存します。

export API_KEY=your_api_key
export AGENT_ID=your_agent_id

AIインターフェースの統合

Cursor IDEまたはClaude Desktopにサーバーを設定するには、以下の手順を実行します。

1. uvのパスを見つけます。

which uv  # または locate uv

2. config.jsonファイルを作成して編集し、以下の内容を追加します。

{
  "server": {
    "host": "localhost",
    "port": 8000
  },
  "tools": {
    "tool1": {
      "command": "python tool.py"
    }
  }
}

環境設定

uvを使用して依存関係を管理します。

uv init --python
uv run myapp

使用方法

Cursorでの質問例を示します。

# 質問例
server.get_current_time()

サーバーの処理フローは以下の通りです。

1. クエリリクエストを受け取ります。
2. ツール関数を解析して実行します。
3. 結果を返します。

開発

サーバーの変更

新しい機能を追加するには、以下の手順を実行します。

1. 新しいツールを追加するには、追加の関数を作成し、@mcp.tool()デコレータを使用します。

@mcp.tool()
def new_tool(param: str) -> str:
    """ツールの機能を説明"""
    # 実装コード
    return 結果

制限事項

• サーバーはローカルで実行されるため、リモート開発環境では使用できない場合があります。
• ツールの応答は、Contextual AI APIの制限とクォータの影響を受けます。
• 現在はstdio伝送モードのみがサポートされています。

Contextual AIのすべての機能については、公式ドキュメントを参照してください。