Easymcp

🚀 easyMcp

開発者が2ステップで拡張可能なMCPサーバーフレームワークを迅速に構築できるよう支援します。標準入出力とSSEの2種類の起動モードをサポートしています。

🚀 クイックスタート

1. 最初のステップ[オプション] 必要な設定を定義する

src/config/.envファイルに、プロジェクトに必要な設定を定義します。例えば、データベース設定は次のようになります。

 # MySQL データベース設定
MYSQL_HOST=192.168.3.229
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD=root
MYSQL_DATABASE=a_llm
MYSQL_ROLE=admin

2. 独自のツールを作成する

独自に定義したツールクラスをsrc/handlesディレクトリに追加し、example.pyのサンプルを参考にします。

• BaseHandlerクラスを継承する
• name属性を定義して、ツールの名前を表す
• description属性を定義して、ツールの説明を表す
• get_tool_descriptionメソッドを実装して、MCPクライアントにツールの機能を伝える
• run_toolメソッドを実装して、MCPクライアントから呼び出されてツールのロジックを実行する
• __init__.pyで新しいツールを参照する

example.py

from typing import Dict, Any, Sequence

from mcp import Tool
from mcp.types import TextContent
from .base import BaseHandler
from config import get_config


class Example(BaseHandler):
    name = "get_Example"
    description = (
        "this is Example xxxx"
    )

    def get_tool_description(self) -> Tool:
        return Tool(
            name=self.name,
            description=self.description,
            inputSchema={
                "type": "object",
                "properties": {
                    "text": {
                        "type": "string",
                        "description": "これは必須のテキスト入力内容です"
                    }
                },
                "required": ["text"]
            }
        )

    async def run_tool(self, arguments: Dict[str, Any]) -> Sequence[TextContent]:

            try:
                if "text" not in arguments:
                    raise ValueError("テキスト内容が不足しています")

                text = arguments["text"]

                # 設定情報を参照する
                config = get_config()

                ## todo something

                result = "xxxxxxx"

                # すべての結果をカンマで連結する
                return [TextContent(type="text", text=','.join(result))]

            except Exception as e:
                return [TextContent(type="text", text=f"エラー: {str(e)}")]

__init__.py

from .example import Example


__all__ = [
    "Example",
]

3. 起動

現在、このフレームワークは2種類の起動モードをサポートしています：標準入出力とSSE。

1. SSE モード

• uvを使用してサービスを起動する

MCPクライアントツール（例えば、cursor、clineなど）に以下の内容を追加します。

MCP JSONは次のようになります。

{
  "mcpServers": {
    "easyMcp": {
      "name": "easyMcp",
      "description": "",
      "isActive": true,
      "baseUrl": "http://localhost:9000/sse"
    }
  }
}

起動コマンド

# 依存関係をダウンロードする
uv sync

# 起動する
uv start

2. STDIO モード

• ターミナルで以下のコマンドを実行してサービスを起動します。

python main.py

注意事項

⚠️ 重要提示

• すべての必要な依存関係が正しくインストールされていることを確認してください。
• SSEモードを使用する場合は、ネットワーク接続が安定していることを確認してください。
• 問題が発生した場合は、ログファイルを確認して詳細情報を取得してください。