MCP Server Poc

🚀 MCP サーバー POC

このプロジェクトは、Model Context Protocol (MCP) サーバーの概念実証実装で、カスタムツールとリソースを通じてAIアシスタントの機能を強化します。

🚀 クイックスタート

このプロジェクトでは、Model Context Protocol (MCP) サーバーの作成と使用方法を紹介しています。このサーバーは、MCP 標準をサポートする AI アシスタント（Claude など）にカスタムツールとリソースを提供できます。

✨ 主な機能

• LangChain、LlamaIndex および OpenAI のドキュメント検索ツール
• ウェブページのスクレイピング機能
• Google Search API の統合

📦 インストール

前提条件

• Python 3.11
• requirements.txt に記載されている必要なパッケージ

インストール手順

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

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

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

# uv パッケージマネージャーを初期化
uv init

# Python 3.11 の仮想環境を作成
uv venv

# Windows でのアクティブ化
.venv\Scripts\activate

# macOS/Linux でのアクティブ化
source venv/bin/activate

3. 必要なパッケージをインストールします：

uv pip install -r requirements.txt

4. （オプション）開発または代替統合が必要な場合は、MCP CLI ツールをインストールします：

uv add "mcp[cli]"

5. 環境変数を設定します： ルートディレクトリに .env ファイルを作成し、以下の内容を記述します。

SERPER_API_KEY=your_serper_api_key_here

💻 使用例

アプリケーションの実行

MCP サーバーを実行するには：

uv run mcp 

サーバーが起動し、stdio 転送方法を使用した接続を待機します。

Cursor との統合

この MCP サーバーを Cursor IDE と連携させるには：

1. ファイル ~/.cursor/mcp.json（Windows では C:\Users\<username>\.cursor\mcp.json）を作成または編集し、以下の内容を記述します。

{
    "mcpServers": {
        "mcp-server": {
            "command": "python", 
            "args": [
                "ABSOLUTE/PATH/TO/main.py"
            ]
        }
    }
}

2. パスを main.py ファイルの絶対パスに置き換えます。
   • Windows では、ダブルバックスラッシュを使用します：C:\\Users\\username\\path\\to\\main.py
   • macOS/Linux では、通常のスラッシュを使用します： /Users/username/path/to/main.py
3. Cursor を完全に再起動（バックグラウンドプロセスも終了）して、MCP サーバーを読み込みます。

ツールの使用

• get_docs(query, library): 指定されたライブラリ（langchain、llama-index または openai）のドキュメントを検索し、関連情報を返します。

🔧 技術詳細

Windows バイナリモードの修正

このサーバーには、Windows で stdio 転送を正しく動作させるための特定の修正プログラムが含まれています。

# Windows で (stdin/stdout) のバイナリモードを設定
if os.name == 'nt':
    import msvcrt
    msvcrt.setmode(sys.stdin.fileno(), os.O_BINARY)
    msvcrt.setmode(sys.stdout.fileno(), os.O_BINARY)

この修正は、Windows がテキストモードとバイナリモードのファイル処理を区別するため、stdio 転送メカニズムに問題が発生する可能性があるため必要です。

📚 トラブルシューティング

Windows 固有の問題

• “Failed to create client” または “Client closed” エラー：
  • 含まれているバイナリモードの修正プログラムを使用していることを確認します。
  • 設定ファイルでダブルバックスラッシュを使用した絶対パスを使用します。
  • MCP サーバーを直接実行して、エラー出力を確認します。
  • Cursor を完全に終了（タスクマネージャーでバックグラウンドプロセスも終了）してから再起動します。

一般的な問題

• すべての必要なパッケージがインストールされていることを確認します（pip list で確認）。
• 設定ファイルの絶対パスが正しいことを確認します。
• MCP サーバーが正しい Python バージョン（3.11）を使用していることを確認します。
• .env ファイルに必要な API キーが含まれていることを確認します。
• MCP パッケージを再インストールしてみます：pip uninstall mcp && pip install mcp

📄 ライセンス

MIT License

👏 謝辞

• このプロジェクトは Model Context Protocol SDK を使用しています。
• ウェブスクレイピング機能は crawl4ai から提供されています。