小队 MCP 服务器
模型上下文协议 (MCP) 服务器将Squad （AI 驱动的产品发现和战略平台）连接到任何支持 MCP 的大型语言模型 (LLM) 应用程序。它提供了丰富的工具包，可直接从您最喜欢的 AI 助手创建、查询和更新产品战略成果（机会、解决方案、成果、需求、知识、工作空间和反馈）。
该存储库还包含@squadai/tools NPM 包的源代码，该包提供了与 Squad API 交互的客户端工具。
为什么？
使用 Squad MCP 服务器，您可以在一个对话流程中研究、构思和规划产品，而无需离开编辑器或聊天窗口。
Related MCP server: Algolia
✨ 工具
工具前缀 | 目的 | 典型操作 |
机会_* | 发现并完善产品机会 | 创建、列出、更新 |
解决方案_* | 生成并迭代解决方案 | 创建、列出、更新 |
结果_* | 跟踪所需的业务或用户成果 | 创建、列出 |
要求_* | 捕捉详细需求 | 创建、列出 |
知识_* | 存储有用的参考资料/研究 | 创建、列出 |
工作区_* | 管理小队工作区 | 获取、更新 |
反馈_* | 将客户或分析反馈发送至 Squad | 创造 |
每个工具都符合 MCP JSON 模式格式，因此代理可以自动检查输入和输出。
🚀 快速入门
1·获取 Squad API 密钥
在https://meetsquad.ai注册/登录。
打开设置 → 开发者 → API 密钥。
创建一个键并复制其值。
2·运行服务器
选择适合您环境的安装方法。
选项 A – 独立可执行文件*（建议本地使用）*
从项目的GitHub 发布页面下载适合您的操作系统的最新二进制文件并直接运行它：
# Windows
squad-mcp.exe
# macOS / Linux — make the file executable first
chmod +x squad-mcp
./squad-mcp
以通常的方式传递环境变量：
SQUAD_API_KEY=<your‑key> SQUAD_ENV=production ./squad-mcp
选项 B – Docker （推荐用于生产）
# Build the image (once)
docker build -t mcp/meet-squad -f Dockerfile .
# Run the server on stdio
docker run --rm -i \
-e SQUAD_API_KEY=<your‑key> \
mcp/meet-squad
选项 C – 来自源头
git clone https://github.com/the-basilisk-ai/squad-mcp.git
cd squad-mcp
npm install
npm run build # transpiles to ./dist
node dist/index.js
📦 NPM 包（@squadai/tools）
该存储库还包含一个 NPM 包@squadai/tools ，它提供了一组函数，用于从您自己的 Node.js 应用程序或脚本以编程方式与 Squad API 进行交互。
要安装该包：
npm install @squadai/tools
# or
yarn add @squadai/tools
# or
pnpm add @squadai/tools
然后，您可以在代码中导入并使用这些工具。您仍然需要 Squad API 密钥或 JWT 进行身份验证（请参阅上面的“快速入门”部分）。
使用示例（Vercel AI）：
import { generateText, tool } from 'ai';
import { tools as squadTools } from "@squadai/tools"
const result = await generateText({
model: yourModel,
tools: squadTools({
jwt: "JWT",
orgId: "orgId",
workspaceId: "workspaceId"
}),
prompt: 'What is the weather in San Francisco?',
});
⚙️ 与 MCP 客户端集成
在客户端配置中添加mcpServers条目（例如claude_desktop_config.json或Cursor ）。调整命令以匹配安装方法。
使用独立可执行文件
{
"mcpServers": {
"meet-squad": {
"command": "C:/path/to/squad-mcp.exe",
"env": {
"SQUAD_API_KEY": "YOUR_API_KEY_HERE",
}
}
}
}
使用 Docker
{
"mcpServers": {
"meet-squad": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e", "SQUAD_API_KEY",
"mcp/meet-squad"
],
"env": {
"SQUAD_API_KEY": "YOUR_API_KEY_HERE",
}
}
}
}
如果您通过 NPX 安装，则首选"command": "npx" 。
客户端重新启动后，您应该会看到小队工具（锤子🔨图标）列出并可供使用。
🛠️ 环境变量
多变的 | 必需的 | 默认 | 描述 |
SQUAD_API_KEY
| 是的 | – | Squad 中生成的个人访问令牌 |
SQUAD_ENV
| 不 | production
| 覆盖 Squad API 基本 URL（ staging
、 development
……） |
🧑💻开发
npm install
npm run format
npm run openapi:squad # re‑generate typed client from openapi/squad.json
npm run build
node dist/index.js
测试套件正在进行中；欢迎贡献。