MCP Server 8kh

🚀 mcp-server 日本語ガイド

簡単な MCP サーバーで、langchain、openai、lama - index などのツールの最新ドキュメントを取得できます。

🚀 クイックスタート

システム要件

• Python 3.10 以上
• MCP SDK 1.2.0 以上
• uv パッケージマネージャー

uv パッケージマネージャーのインストール

MacOS/Linux では、以下のコマンドを実行します。

curl -LsSf https://astral.sh/uv/install.sh | sh

uv コマンドを有効にするために、ターミナルを再起動してください。

プロジェクトのセットアップ

1. プロジェクトの作成と初期化：

# 新しいディレクトリを作成してプロジェクトを初期化
uv init mcp-server
cd mcp-server

# 仮想環境を作成してアクティブ化
uv venv
source .venv/bin/activate

# 依存関係をインストール
uv add "mcp[cli]" httpx

2. サーバー実装ファイルの作成：

touch main.py

サーバーの起動

1. MCP サーバーを起動：

uv run main.py

2. サーバーが起動し、接続を待機します。

💻 使用例

基本的な使用法

Claude Desktop への接続手順：

1. 公式サイトから Claude Desktop をインストールします。
2. Claude Desktop があなたの MCP サーバーを使用するように設定します。

~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

{
    "mcpServers": {
        "mcp-server": {
            "command": "/ABSOLUTE/PATH/TO/YOUR/uv",  # uv コマンドの絶対パスを使用することをおすすめ
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/YOUR/mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}

3. Claude Desktop を再起動します。

トラブルシューティング

Claude Desktop がサーバーを認識しない場合：

1. 設定ファイルのパスとアクセス権限を確認してください。
2. 設定内の絶対パスが正しいことを確認してください。
3. uv が正しくインストールされ、アクセス可能であることを確認してください。
4. Claude Desktop のログに記載されているエラーメッセージを確認してください。