关于 woody-mcp
woody-mcp 是面向枪械问题的 MCP 服务,结合带引文的回答、经过验证的知识库和按司法辖区提供的法律查询。它适用于需要枪械规格、维护、弹道或法律信息的 MCP 客户端。
主要功能
- 01提供带引文的枪械问答
- 02搜索经过验证的枪械知识
- 03查询州级法律信息
- 04将复杂问题路由给专业 Agent
- 05查看能力与支持的口径
适用场景
- 01查找制造商规格
- 02研究枪械维护问题
- 03查询特定州的法律信息
- 04将复杂弹道问题交给专业 Agent
MCP 相关
提供提问、搜索知识库和检查状态的工具,并提供能力与支持口径的资源。MCP 兼容客户端可将其添加为原生工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
uvx woody-mcpWOODY_API_KEY密钥Woody API key (wdy_...). Request one at [email protected] or via https://app.gunsmith.academy/developer本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
3收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| state | string | 否 | |
| question | string | 是 | |
| user_tier | string | 否 |
详细介绍
woody-mcp
mcp-name: io.github.Gunsmith-Academy/woody-mcp
Woody 的 MCP 服务。Woody 是一位枪械领域的 AI 专家,拥有经过验证的知识库、针对特定司法管辖区的法律引擎,以及多 Agent 专家路由功能。
将 Woody 添加为 Claude Desktop、Claude Code、Cursor、Windsurf 或任何兼容 MCP 的客户端中的原生工具。
Woody 能做什么
- 通过经过验证的引用回答任何枪械问题(组装、维护、法律、弹道学、产品规格)
- 查询特定州的枪械法律,并提供考虑司法管辖区差异的引用
- 搜索精选知识库中的制造商规格和经社区验证的数据
- 将复杂问题路由给专业 Agent(法律、弹道学、维护)
安装
pip install woody-mcp
或使用 uvx(无需安装):
uvx woody-mcp
获取 API 密钥
发送邮件至 [email protected] 申请 wdy_ API 密钥。
套餐:
- 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
然后在 shell 环境中设置密钥:
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 为专有软件。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。