amtb-mcp

amtb-mcp

AMTB のリソース／ツールとやり取りするための MCP サーバー

Claude Desktop での使用

Claude Desktop で使用するには、claude_desktop_config.json に以下を追加します：

{
  "mcpServers": {
    "amtb": {
      "command": "python",
      "args": ["{your_path}/amtb-mcp/run_mcp.py"]
    }
  }
}

クイックスタート

必要条件

• Python 3.13 以降（推奨）
• pip
• オプション：ドキュメント変換ツールで .doc → .docx に変換する場合は、LibreOffice（soffice）または pywin32。

セットアップ（Windows）

1. python -m venv .venv
2. ..venv\Scripts\Activate.ps1 # PowerShell または ..venv\Scripts\activate.bat # cmd

インストール

• pip install -e .

ローカルで実行

• MCP サーバーを起動します（stdio トランスポート）：

  python run_mcp.py

  これにより、ローカルでのテストや MCP クライアント（例：Claude Desktop）での利用に向けて、実装済みのツールが stdio 上で公開されます。

• 代わりに、メインモジュールを直接実行することもできます：

  python main.py

テスト

• 単体テストを実行します：

  python -m unittest discover -v

  または、pytest を使う場合：

  pytest

ツールを直接使用する（開発用）

• 動作確認のため、Python からラッパーを呼び出します。例：

  python -c "from fetch_tool import fetch_amtb_menu; print(fetch_amtb_menu(write_files=False))"

  python -c "from main import get_amtb_categories; print(get_amtb_categories())"

注意事項

• fetch_amtb_menu は menu.json とカテゴリごとのファイルを out_dir（デフォルト：amtb）に書き込みます。ドライランには write_files=False を使用します。
• ダウンロードおよび変換ツールはオプトイン方式で、有効化には追加のシステムパッケージや時間が必要になる場合があります。
• 開発時は、新しいツールモジュールを amtb-mcp/ の下に配置し、main.py に登録します（または、モジュールのインポート時に mcp.tool() を呼び出すモジュールをインポートします）。

コントリビューション

• ツールモジュールを追加し、テストを含めて PR を送信します。操作は冪等に保ち、JSON にシリアライズ可能な Pydantic モデルを返してください。

ライセンス

• リポジトリのルートにある LICENSE を参照してください。