小队MCP服务器
A. 模型上下文协议(MCP)服务器 连接 _小队_ --AI驱动的产品发现和战略平台——适用于任何支持MCP的大型语言模型(LLM)应用程序。它提供了一个丰富的工具包,用于直接从您最喜欢的人工智能副驾驶那里创建、查询和更新产品战略工件(机会、解决方案、结果、需求、知识、工作空间和反馈)。
此存储库还包含 @squadai/tools NPM包,它提供了用于与Squad API交互的客户端工具。
为什么?
使用Squad MCP Server,您可以在一个对话流中研究、构思和规划产品,而无需离开编辑器或聊天窗口。
✨ 工具
| 工具前缀 | 目的 | 典型操作 |
|---|---|---|
| 机会\_\* | 发现和改进产品机会 | 创建、列出、更新 |
| 解决方案\_\* | 生成并迭代解决方案 | 创建、列出、更新 |
| outcome\_\* | 跟踪期望的业务或用户结果 | 创建、列出 |
| 知识\_\* | 存储有用的参考文献 / 研究 | 创建、列出 |
| workspace\_\* | 管理小队工作区 | 获取、更新 |
| feedback\_\* | 将客户或分析反馈发送到Squad | 创建 |
每个工具都符合MCP JSON模式格式,因此代理可以自动自检输入和输出。
🚀 快速启动
1·获得小队API密钥
- 注册 / 登录地址 .
- 打开 设置→ 开发者→ API密钥.
- 创建一个键并复制值。
2·运行服务器
选择适合您环境的安装方法。
选项A–独立可执行*(建议当地使用)*
从项目的 页面并直接运行它:
# Windows
squad-mcp.exe
# macOS / Linux — make the file executable first
chmod +x squad-mcp
./squad-mcp以通常的方式传递环境变量:
SQUAD_API_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= \
mcp/meet-squad选项C——NPX _(建议易于设置)_
# Run directly with npx (no installation required)
SQUAD_API_KEY= npx @squadai/tools
# Or pass API key as command argument
npx @squadai/tools --api-key 选项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客户端集成
添加a _mcpServers_ 进入客户端的配置(例如。 claude_desktop_config json 或 光标).调整 命令 以匹配安装方法。
使用独立可执行文件
{
"mcpServers": {
"@squadai/tools": {
"command": "C:/path/to/squad-mcp.exe",
"env": {
"SQUAD_API_KEY": "YOUR_API_KEY_HERE",
},
},
},
}使用Docker
{
"mcpServers": {
"@squadai/tools": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "SQUAD_API_KEY", "mcp/meet-squad"],
"env": {
"SQUAD_API_KEY": "YOUR_API_KEY_HERE",
},
},
},
}使用NPX
{
"mcpServers": {
"squad": {
"command": "npx",
"args": ["@squadai/tools"],
"env": {
"SQUAD_API_KEY": "YOUR_API_KEY_HERE",
},
},
},
}Claude代码集成
对于 克劳德代码,您可以使用以下命令添加Squad MCP服务器:
claude mcp add squad -e SQUAD_API_KEY=YOUR_API_KEY_HERE -- npx @squadai/tools这将使Squad工具在您的所有Claude Code会话中可用。
一旦你的客户端重新启动,你应该看到Squad工具(锤子🔨 图标)列出并准备使用。
🛠️ 环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
SQUAD_API_KEY | 是 | – | 小队中生成的个人访问令牌 |
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测试套件正在进行中;欢迎捐款。
