模型上下文协议服务器

一个连接Squad AI产品发现平台与支持MCP的大型语言模型应用的服务器,提供创建、查询和更新产品策略工件的工具集。

  • by the-basilisk-ai
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 the-basilisk-ai/squad-mcp

使用说明

小队MCP服务器

A. 模型上下文协议(MCP)服务器 连接 小队 --AI驱动的产品发现和战略平台——适用于任何支持MCP的大型语言模型(LLM)应用程序。它提供了一个丰富的工具包,用于直接从您最喜欢的人工智能副驾驶那里创建、查询和更新产品战略工件(机会、解决方案、结果、需求、知识、工作空间和反馈)。

此存储库还包含 @squadai/tools NPM包,它提供了用于与Squad API交互的客户端工具。

为什么?

使用Squad MCP Server,您可以在一个对话流中研究、构思和规划产品,而无需离开编辑器或聊天窗口。

✨ 工具

工具前缀 目的 典型操作
机会_* 发现和改进产品机会 创建、列出、更新
解决方案_* 生成并迭代解决方案 创建、列出、更新
outcome_* 跟踪期望的业务或用户结果 创建、列出
知识_* 存储有用的参考文献 / 研究 创建、列出
workspace_* 管理小队工作区 获取、更新
feedback_* 将客户或分析反馈发送到Squad 创建

每个工具都符合MCP JSON模式格式,因此代理可以自动自检输入和输出。

🚀 快速启动

1·获得小队API密钥

  1. 注册 / 登录地址 https://meetsquad.ai.
  2. 打开 设置→ 开发者→ API密钥.
  3. 创建一个键并复制值。

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——NPX (建议易于设置)

# Run directly with npx (no installation required)
SQUAD_API_KEY=<your‑key> npx @squadai/tools

# Or pass API key as command argument
npx @squadai/tools --api-key <your‑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

测试套件正在进行中;欢迎捐款。