South Asia

🚀 南アジア地域 MCP ツール

このツールは、MCP (Model Control Protocol) フレームワークに基づくツール開発テンプレートです。MCP フレームワークを利用し、特定のタスクを効率的に実行することができます。

🚀 クイックスタート

このツールを使用する前に、以下の手順でツール名の設定、インストール、および設定を行ってください。

✨ 主な機能

• ツール名の柔軟な設定が可能です。
• 仮想環境を利用した開発ができ、環境の衝突を避けることができます。
• 新しい機能の開発が容易で、モジュール化された構造と適切なコメント、エラーハンドリングをサポートしています。

📦 インストール

ツール名の設定

ツール名を変更する場合は、以下の場所を修正してください。

1. src/southasia/server.py の定数設定

MCP_TOOL_NAME = "southAsia"  # ここを変更してツール名を修正

2. pyproject.toml のコマンドラインツール名（小文字で指定）

[project.scripts]
southasia = "southasia.server:main"  # "southasia" を任意の名前に変更

3. Cursor 設定ファイルのツール名

{
    "tools": {
        "southAsia": {
            "command": "python -m southasia.server"
        }
    }
}

仮想環境の作成とアクティブ化（オプション）

Windows の PowerShell またはコマンドプロンプトを使用して、以下の手順で仮想環境を作成し、アクティブ化します。

1. プロジェクトディレクトリに移動します。

cd your_project_directory

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

python -m venv myenv
.\myenv\Scripts\activate.ps1  # PowerShell で使用

開発版のインストール

プロジェクトのルートディレクトリで以下のコマンドを実行して、開発版をインストールします。

pip install -e .

Cursor の設定

config.json ファイル（通常は %USERPROFILE%\.cursor\mcp.json）を編集または作成し、以下の内容を追加します。

{
    "tools": {
        "southasia": {
            "command": "python -m southasia.server"
        }
    }
}

💻 使用例

基本的な使用法

サーバーの起動

以下のコマンドでサーバーを起動します。

southasia  # 実行可能ファイルとしてインストールされている場合
# または
python -m southasia.server

ツールのテスト

以下のコマンドでツールをテストします。

@southasia hello_world

高度な使用法

新しい機能を開発するには、Tool_GUIDE.md を参照してください。主な手順は以下の通りです。

1. handlers/ ディレクトリに新しいハンドラーファイルを作成します。
2. ツールリストの定義（handle_list_tools）と呼び出し処理（handle_call_tool）を実装します。
3. server.py で新しいツールをインポートし、登録します。

サンプルツールの実装

src/southasia/handlers/hello_world.py は、以下のようにツールを定義し、呼び出しを処理するサンプルを提供しています。

ツールリストの定義

def handle_list_tools():
    return [{
        "name": "hello_world",
        "description": "返回 'Hello, World!' 消息"
    }]

呼び出しの処理

async def handle_call_tool(tool_name, params):
    if tool_name == "hello_world":
        return "Hello, World!"
    raise ValueError(f"未知工具名称: {tool_name}")

🔧 技術詳細

このツールは、MCP フレームワークに基づいて開発されています。ツール名の設定、仮想環境の使用、新機能の開発など、柔軟な運用が可能です。また、モジュール化された構造と適切なコメント、エラーハンドリングをサポートしているため、開発者は容易に新しい機能を追加することができます。

📄 ライセンス

この README ではライセンス情報が提供されていません。

⚠️ 重要提示

• すべての変更は、サーバーを再起動すると有効になります。
• 環境の衝突を避けるため、仮想環境で開発することをお勧めします。
• モジュール化された構造とコードスタイルに従い、適切なコメントとエラーハンドリングを追加してください。

関連ファイル

• Tool_GUIDE.md：詳細なツール開発ガイド
• src/southasia/handlers/hello_world.py：サンプルツールの実装
• src/southasia/server.py：サーバーの設定とツールの登録