English Français العربية

io.github.Gunsmith-Academy/woody-mcp

السجل الرسمي الحكومة والقانون

Woody, the AI firearms expert. Verified specs, legal lookups, and knowledge base.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package woody-mcp
Claude Code 
claude mcp add woody-mcp -e 'WOODY_API_KEY=<your woody_api_key>' -- uvx woody-mcp==1.0.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "woody-mcp": {
            "command": "uvx",
            "args": [
                "woody-mcp==1.0.3"
            ],
            "env": {
                "WOODY_API_KEY": "<your woody_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • WOODY_API_KEY إلزامي سري Woody API key (wdy_...). Request one at gsa@gunsmith.academy or via https://app.gunsmith.academy/developer

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. woody-mcp
  2. What Woody can do
  3. Install
  4. Get an API key
  5. Claude Desktop setup
  6. Claude Code setup
  7. Tools
  8. Resources
  9. License

woody-mcp

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

MCP server for Woody, an AI firearms expert with a verified knowledge base, jurisdiction-specific legal engine, and multi-agent specialist routing.

Add Woody as a native tool in Claude Desktop, Claude Code, Cursor, Windsurf, or any MCP-compatible client.

What Woody can do

  • Answer any firearms question with verified citations (builds, maintenance, legal, ballistics, product specs)
  • Look up state-specific firearms laws with jurisdiction-aware citations
  • Search a curated knowledge base of manufacturer specs and community-verified data
  • Route complex questions to specialist agents (legal, ballistics, maintenance)

Install

pip install woody-mcp

Or with uvx (no install needed):

uvx woody-mcp

Get an API key

Email gsa@gunsmith.academy to request a wdy_ API key.

Tiers:

  • kb_only — Free. KB search only, no AI answers.
  • standard — $9/mo. Full AI answers, 30 req/min.
  • premium — $29/mo. AI answers + Ballistic Solver + legal engine, 60 req/min.

Claude Desktop setup

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Restart Claude Desktop. Woody's tools will appear automatically.

Claude Code setup

claude mcp add woody -- woody-mcp

Then set your key in your shell environment:

export WOODY_API_KEY=wdy_your_key_here

Tools

ask_woody

Ask Woody any firearms question. Returns an expert answer with citations and legal disclaimers where applicable.

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

Search Woody's verified KB directly. Pure vector retrieval, no AI inference, near-zero latency.

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

Check Woody's current capabilities and KB version. No API key required.

Resources

  • woody://capabilities — Full tool manifest with input schemas
  • woody://supported-calibers — List of calibers Woody can analyze

License

MIT for the MCP client. The Woody API is proprietary.

الأسئلة الشائعة

ما هو io.github.Gunsmith-Academy/woody-mcp؟

Woody, the AI firearms expert. Verified specs, legal lookups, and knowledge base.

كيف أثبّت io.github.Gunsmith-Academy/woody-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add woody-mcp -e 'WOODY_API_KEY=<your woody_api_key>' -- uvx woody-mcp==1.0.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Gunsmith-Academy/woody-mcp إلى مفتاح API؟

نعم. يتطلب WOODY_API_KEY، وتضبطها في إعداداته.

هل io.github.Gunsmith-Academy/woody-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.Gunsmith-Academy/woody-mcp؟

ينشره Gunsmith-Academy. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.