woody-mcp

woody-mcp

mcp-name: io.github.Gunsmith-Academy/woody-mcp

Woody 用 MCP サーバーです。Woody は、検証済みのナレッジベース、管轄区域ごとの法律エンジン、複数のエージェントによる専門家への振り分け機能を備えた、銃器分野の AI 専門家です。

Claude Desktop、Claude Code、Cursor、Windsurf、その他の MCP 対応クライアントに、Woody をネイティブツールとして追加できます。

Woody でできること

• あらゆる銃器に関する質問に、検証済みの出典を添えて回答します（ビルド、メンテナンス、法律、弾道学、製品仕様）。
• 管轄区域に応じた出典を添えて、州ごとの銃器法を調べます。
• メーカー仕様とコミュニティで検証されたデータを集めた、厳選されたナレッジベースを検索します。
• 複雑な質問を専門エージェント（法律、弾道学、メンテナンス）に振り分けます。

インストール

pip install woody-mcp

または、uvx を使用します（インストール不要）。

uvx woody-mcp

API キーを取得する

wdy_ API キーを申請するには、[email protected] にメールでお問い合わせください。

プラン：

• kb_only — 無料。KB の検索のみで、AI による回答はありません。
• standard — 月額 $9。AI による回答、毎分 30 リクエスト。
• premium — 月額 $29。AI による回答 + Ballistic Solver + 法律エンジン、毎分 60 リクエスト。

Claude Desktop のセットアップ

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "woody": {
      "command": "woody-mcp",
      "env": {
        "WOODY_API_KEY": "wdy_your_key_here"
      }
    }
  }
}

Claude Desktop を再起動します。Woody のツールが自動的に表示されます。

Claude Code のセットアップ

claude mcp add woody -- woody-mcp

次に、シェル環境でキーを設定します。

export WOODY_API_KEY=wdy_your_key_here

ツール

ask_woody

Woody に銃器に関する質問をします。該当する場合は、出典と法律上の免責事項を含む専門家の回答が返されます。

question: str        — The firearms question (max 2000 chars)
state: str           — US state code for legal questions (e.g. "TX")
user_tier: str       — matches your API key tier: "free" (kb_only key),
                       "operator" (standard key), or "patriot"/"armorer" (premium key)

search_knowledge_base

Woody の検証済み KB を直接検索します。AI による推論を行わない純粋なベクトル検索で、レイテンシーはほぼゼロです。

query: str    — Search query
top_k: int    — Number of results (1-10, default 3)

check_woody_status

Woody の現在の機能と KB のバージョンを確認します。API キーは不要です。

リソース

• woody://capabilities — 入力スキーマを含むツールマニフェスト全体
• woody://supported-calibers — Woody が分析できる口径の一覧

ライセンス

MCP クライアントは MIT ライセンスです。Woody API はプロプライエタリです。