Woody Mcp

io.github.Gunsmith-Academy由 GitHub 账号 Gunsmith-Academy 发布v1.0.3更新于 Oct 24, 2026

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

已验证STDIO仅桌面知识与记忆AI 与机器学习

概览

AI 生成的概览

Woody MCP 为助手提供枪械知识库、按司法辖区检索的法律查询，以及构建、弹道和维护问题的专家分流。

可以做什么
Woody MCP 通过三个工具提供 AI 枪械专家能力。ask_woody 回答枪械问题并附引用，必要时给出法律免责声明，可按美国州代码限定范围。search_knowledge_base 在厂商规格与社区验证数据的精选知识库上做纯向量检索，不做 AI 推理。check_woody_status 无需 API 密钥即可查看当前能力与知识库版本。另有两个资源提供工具清单与支持的弹药口径。
适用场景
适合在聊天客户端内需要带引用的枪械信息、州级法律查询，或弹道与维护指导的场景。免费档仅支持知识库检索；AI 回答与法律引擎需要付费档。
运行要求
需要本地 Python 运行环境（pip install woody-mcp，或用 uvx woody-mcp 免安装）。需要 Woody API 密钥，放在 WOODY_API_KEY 环境变量中，可通过邮件或开发者页面申请。仅支持桌面 MCP 客户端，无网页版。需要访问 Woody 服务的网络连接。
安装前请注意
该服务器需要密钥 WOODY_API_KEY，需写入客户端配置文件或 shell 环境。付费档为每月 9 美元（standard）或 29 美元（premium），且 user_tier 参数必须与密钥档位一致。问题内容与州代码会发送至第三方服务处理。回答附带法律免责声明，不能替代专业法律意见。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Woody Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

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

bash
pip install woody-mcp

Or with uvx (no install needed):

bash
uvx woody-mcp

Get an API key

Email [email protected] 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):

json
{  "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

bash
claude mcp add woody -- woody-mcp

Then set your key in your shell environment:

bash
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 querytop_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.

来源：README.md，提交 37d2164

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分