@vj-presidio/specif-ai-mcp-server

一个通过 stdio 运行 MCP (模型上下文协议) 服务器的 CLI 工具，用于 Specif-ai。

安装 & 使用概览

graph TD
    A[安装选项]

    A --> B[直接二进制安装]
    A --> C[包管理器安装]

    B --> D[Unix 脚本]
    B --> E[Windows PowerShell]

    C --> F[NPM 全局]
    C --> G[Bun 全局]

    B --> H1[何时使用二进制安装]
    H1 --> I1[系统范围安装]
    H1 --> I2[无需 Node.js]
    H1 --> I3[最小依赖]

    C --> H2[何时使用包管理器]
    H2 --> J1[已在使用 Node.js/Bun]
    H2 --> J2[需要自动更新]
    H2 --> J3[项目特定版本]

    K[使用方法]
    K --> L[直接 CLI]
    K --> M[NPX]
    K --> N[BunX]

    L --> O1[全局安装]
    L --> O2[启动速度最快]

    M --> P1[无需安装]
    M --> P2[版本灵活性]

    N --> Q1[Bun 运行时用户]
    N --> Q2[更好的性能]

安装

直接二进制安装 (推荐)

您可以使用我们的安装脚本直接安装二进制文件：

# Unix (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/install.sh | sh

# 安装特定版本
curl -fsSL https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/install.sh | sh -s -- -v 1.2.3

# Windows (PowerShell)
iwr -useb https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/install.ps1 | iex

# 安装特定版本
iwr -useb https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/install.ps1 | iex -v 1.2.3

或者从 Releases 页面手动下载适用于您平台的二进制文件。

包管理器安装

您可以使用 npm 全局安装：

# 最新版本
npm install -g @vj-presidio/specif-ai-mcp-server@latest
# 特定版本
npm install -g @vj-presidio/specif-ai-mcp-server@1.2.3

或者使用 bun:

# 最新版本
bun install -g @vj-presidio/specif-ai-mcp-server@latest
# 特定版本
bun install -g @vj-presidio/specif-ai-mcp-server@1.2.3

更新

检查更新：

# Unix (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/update.sh | sh -s -- -c

# Windows (PowerShell)
iwr -useb https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/update.ps1 | iex -c

更新到最新版本：

# Unix (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/update.sh | sh

# Windows (PowerShell)
iwr -useb https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/update.ps1 | iex

更新到特定版本：

# Unix (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/update.sh | sh -s -- -v 1.2.3

# Windows (PowerShell)
iwr -useb https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/update.ps1 | iex -v 1.2.3

MCP 客户端配置示例

使用 npx 和最新版本：

{
  "specif-ai": {
    "command": "npx",
    "args": ["--yes", "@vj-presidio/specif-ai-mcp-server@latest"],
    "disabled": false,
    "autoApprove": []
  }
}

使用 npx 和特定版本：

{
  "specif-ai": {
    "command": "npx",
    "args": ["--yes", "@vj-presidio/specif-ai-mcp-server@1.2.3"],
    "disabled": false,
    "autoApprove": []
  }
}

使用 bunx 和最新版本：

{
  "specif-ai": {
    "command": "bunx",
    "args": ["@vj-presidio/specif-ai-mcp-server@latest"],
    "disabled": false,
    "autoApprove": []
  }
}

使用 bunx 和特定版本：

{
  "specif-ai": {
    "command": "bunx",
    "args": ["@vj-presidio/specif-ai-mcp-server@1.2.3"],
    "disabled": false,
    "autoApprove": []
  }
}

使用直接二进制或包管理器全局安装：

{
  "specif-ai": {
    "command": "specif-ai-mcp-server",
    "args": [],
    "disabled": false,
    "autoApprove": []
  }
}

选项

• --help, -h: 显示帮助信息
• --version: 显示版本信息

Specifai MCP 与流行的 IDE 和扩展集成

请参阅每个的设置说明

1. Cline
2. Cursor

设置项目路径

服务器运行后，您可以使用 set-project-path 工具设置项目路径。 此工具接受包含您的规范文件的目录的路径。 设置路径后，服务器将从该目录加载所有文档。

工具使用示例：

{
  "name": "set-project-path",
  "arguments": {
    "path": "./path/to/project"
  }
}

可用工具

服务器提供多种工具来与您的规范文档进行交互：

工具名称	描述
set-project-path	设置或更改项目目录路径
get-brds	获取业务需求文档
get-prds	获取产品需求文档
get-nfrs	获取非功能性需求
get-uirs	获取用户界面需求
get-bps	获取业务流程文档
get-user-stories	获取特定 PRD 的用户故事
get-tasks	获取特定用户故事的任务
get-task	获取特定任务的详细信息

要求

对于二进制安装：

• curl (Unix) 或 PowerShell (Windows)
• sudo 访问权限 (Unix，用于系统范围安装)

对于包管理器安装：

• Node.js >= 16.0.0
• Bun >= 1.0.0 (如果使用 Bun 运行时)

许可证

MIT