🚀 Squad MCP 服务器
一个模型上下文协议 (MCP) 服务器，可将 Squad（一个由 AI 驱动的产品发现和策略平台）连接到任何支持 MCP 的大型语言模型 (LLM) 应用程序。它提供了丰富的工具包，让您能直接借助喜爱的 AI 协作伙伴，创建、查询和更新产品策略相关的工件（包括机会、解决方案、结果、要求、知识、工作区和反馈）。
此存储库还包含 @squadai/tools NPM 包的源代码，该包提供了用于与 Squad API 进行交互的客户端工具。
🚀 快速开始
1 · 获得 Squad API 密钥
- 在 https://meetsquad.ai 注册/登录。
- 打开 设置 → 开发者 → API 密钥。
- 创建密钥并复制其值。
2 · 运行服务器
选择适合您环境的安装方法。
方法 A – 独立可执行文件（推荐用于本地使用）
从项目 GitHub 发布页面下载最新二进制文件并直接运行：
# Windows
squad-mcp.exe
# macOS / Linux — 首先让文件可执行
chmod +x squad-mcp
./squad-mcp
以常规方式传递环境变量：
SQUAD_API_KEY= SQUAD_ENV=production ./squad-mcp
方法 B – Docker（推荐用于生产）
# 构建镜像（一次）
docker build -t mcp/meet-squad -f Dockerfile .
# 在 stdio 上运行服务器
docker run --rm -i \
-e SQUAD_API_KEY= \
mcp/meet-squad
方法 C – 从源代码
git clone https://github.com/the-basilisk-ai/squad-mcp.git
cd squad-mcp
npm install
npm run build # 转译到 ./dist
node dist/index.js
✨ 主要特性
使用 Squad MCP 服务器，您可以在一个对话流中进行研究、构思和计划产品，而无需离开您的编辑器或聊天窗口。
🛠️ 工具
| 工具前缀 | 目的 | 典型操作 |
|---|---|---|
| opportunity_* | 发现和细化产品机会 | create, list, update |
| solution_* | 生成并迭代解决方案 | create, list, update |
| outcome_* | 跟踪业务或用户的期望结果 | create, list |
| requirement_* | 捕获详细要求 | create, list |
| knowledge_* | 存储有用的参考资料/研究 | create, list |
| workspace_* | 管理 Squad 工作区 | get, update |
| feedback_* | 发送客户或分析反馈到 Squad | create |
每个工具都符合 MCP JSON 模式格式，因此代理可以自动 introspect 输入和输出。
📦 安装指南
此存储库包含 @squadai/tools NPM 包的源代码，该包提供了客户端工具，用于与 Squad API 进行交互。
📚 详细文档
🧑💻 开发
npm install
npm run format
npm run openapi:squad # 从 openapi/squad.json 再生成带类型的客户端
npm run build
node dist/index.js
测试套件正在开发中；欢迎贡献。
🛠️ 环境变量
| 属性 | 详情 |
|---|---|
SQUAD_API_KEY |
在 Squad 生成的个人访问令牌，必需，无默认值 |
SQUAD_ENV |
覆盖 Squad API 基础 URL（staging, development, …），非必需，默认值为 production |