MCPioneer 🚀

MCPioneer 🚀

AI エージェント向けの独自 MCP サーバーを構築

MCPioneer は、Python を使った独自の MCP（Message/Command/Processing）サーバーの作成方法を紹介する、初心者にもわかりやすいプロジェクトです。このサーバーは、AI エージェントの機能を拡張する橋渡し役として、API の呼び出し、データベースへのアクセス、カスタムツールの実行などの外部タスクを可能にします。

---

📚 MCP とは？

MCP サーバーは、AI エージェントが機能を強化するために利用できるツール、リソース、サービスを提供します。基本機能を超える外部の支援が必要なときに AI が開ける「ツールボックス」と考えてください。

---

⚙️ 使用技術

• Python 3.10+
• MXGp Python SDK
• UV パッケージマネージャー
• Claude Desktop（テスト用）

---

🚀 はじめに

1. UV をインストール（より優れたパッケージマネージャー）

• Windows：

  iwr -useb https://mirror.ghproxy.com/https://raw.githubusercontent.com/astral-sh/uv/main/scripts/install.ps1 | iex
  

• Mac/Linux：

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

2. プロジェクトを初期化

uv init .
uv add mcp cli

3. シンプルな MCP サーバーを作成

main.py の例：

from mcp_servers.fast_mcp import FastMCP

server = FastMCP(name="DemoServer")

@server.tool
def add_numbers(a: int, b: int) -> int:
    return a + b

@server.resource
def greet(name: str) -> str:
    return f"Hello, {name}!"

server.run()

4. MCP サーバーを Claude Desktop にインストール

uv run mcp install main.py

5. Claude Desktop を設定

• Settings → Developer → Edit Config に移動します。
• 必要に応じて、設定にサーバーを手動で追加します。
• MCP サーバーがすぐに表示されない場合は、Claude Desktop を再起動します。

---

🛠️ プロジェクト構成

MCPioneer/
├── main.py
├── README.md
├── .venv/ (created automatically)
└── uv.toml

---

---

✨ 作者

Nithin が ❤️ を込めて作成しました。