specMCP (Emergent Company)

SpecMCP

规范驱动的开发MCP服务器，由 涌现 知识图谱。

SpecMCP使AI编码助手能够使用结构化规范，跟踪实施进度，并通过 模型上下文协议.

概述

SpecMCP提供了一个规范锚定的开发工作流程，其中规范与代码一起不断发展。与基于文件的方法不同，SpecMCP使用Emergent的知识图：

• 关系跟踪 -通过类型化关系连接的实体
• 影响分析 -查询受更改影响的内容
• 版本控制 -内置实体版本控制和分支
• 并行执行 -多个代理处理相关任务

先决条件

• 转到1.25+
• 一 涌现 带有API令牌的项目

安装

快速安装（推荐）

使用一个命令安装或升级到最新版本：

curl -fsSL https://raw.githubusercontent.com/emergent-company/specmcp/main/install.sh | sh

这将：

• 开 Arch Linux：使用systemd服务通过pacman安装官方软件包
• 开 macOS/其他Linux：安装到 ~/.specmcp/bin 并添加到PATH

手动安装

Arch Linux

从GitHub版本安装官方软件包：

# Download and install with pacman
wget https://github.com/emergent-company/specmcp/releases/latest/download/specmcp-*-x86_64.pkg.tar.zst
sudo pacman -U specmcp-*-x86_64.pkg.tar.zst

# Enable and start the service (optional)
sudo systemctl enable --now specmcp

该套餐包括：

• 二元的： /usr/bin/specmcp
• 配置： /etc/specmcp/config.toml
• 服务： /usr/lib/systemd/system/specmcp.service

macOS/Linux（通用）

下载适合您平台的二进制文件：

# Detect platform and download
PLATFORM="$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m)"
PLATFORM="${PLATFORM//x86_64/amd64}"
PLATFORM="${PLATFORM//aarch64/arm64}"

wget https://github.com/emergent-company/specmcp/releases/latest/download/specmcp-${PLATFORM}.tar.gz
tar -xzf specmcp-${PLATFORM}.tar.gz
sudo mv specmcp /usr/local/bin/

来源

git clone https://github.com/emergent-company/specmcp.git
cd specmcp
task build

二进制文件将输出到 dist/specmcp.

去安装

go install github.com/emergent-company/specmcp/cmd/specmcp@latest

升级

如果您是通过安装脚本或手动安装的，则可以使用以下方式进行升级：

specmcp upgrade

或者重新运行安装脚本：

curl -fsSL https://raw.githubusercontent.com/emergent-company/specmcp/main/install.sh | sh -s -- upgrade

配置

SpecMCP使用分层配置： 环境变量>配置文件>默认值.

配置文件

复制示例并编辑：

cp specmcp.example.toml specmcp.toml

配置文件搜索顺序（先找到者获胜）：

1. --config 标志（例如。 specmcp --config /path/to/specmcp.toml)
2. SPECMCP_CONFIG env 是
3. ./specmcp.toml （当前目录）
4. ~/.config/specmcp/specmcp.toml

配置文件是TOML格式的，完全是可选的——仅使用env变量就足够了。

环境变量

环境变量始终覆盖配置文件值。

用法

标准模式（默认）

SpecMCP作为stdio MCP服务器运行。将其添加到MCP客户端配置中：

{
  "mcpServers": {
    "specmcp": {
      "command": "specmcp",
      "env": {
        "EMERGENT_TOKEN": "emt_your_token_here",
        "EMERGENT_URL": "https://your-emergent-instance.com"
      }
    }
  }
}

或者直接运行：

EMERGENT_TOKEN=emt_... ./dist/specmcp

HTTP模式

作为独立的HTTP服务器运行。客户端将自己的Emergent令牌作为Bearer标头发送——不需要服务器端令牌：

EMERGENT_URL=http://your-emergent:3002 \
SPECMCP_TRANSPORT=http \
./dist/specmcp

客户端通过以下方式连接 POST /mcp 随着 Authorization: Bearer 。令牌是客户端自己的Emergent项目令牌(emt_*).

健康检查： GET /health

码头工人

docker build -t specmcp .
docker run -p 21452:21452 -e EMERGENT_URL=http://your-emergent:3002 specmcp

能力

工具（31）

• 工作流程 (7): spec_new, spec_artifact, spec_batch_artifact, spec_archive, spec_verify, spec_mark_ready, spec_status
• 查询 (11): list_changes, get_change, get_context, get_component, get_action, get_data_model, get_service, get_scenario, get_patterns, impact_analysis, search
• 任务 (5): generate_tasks, get_available_tasks, assign_task, complete_task, get_critical_path
• 模式 (3): suggest_patterns, apply_pattern, seed_patterns
• 宪法 (2): create_constitution, validate_constitution
• 同步 (3): sync_status, sync, graph_summary

提示（2）

• specmcp-guide -全面使用指南
• specmcp-workflow -分步工作流程指南

资源（3）

• specmcp://entity-model -实体类型和关系参考
• specmcp://guardrails -护栏系统文件
• specmcp://tool-reference -工具使用参考

种子模板

要在Emergent项目中注册SpecMCP模板包，请执行以下操作：

EMERGENT_TOKEN=emt_... task seed

发展

task build    # Build binary
task test     # Run tests
task fmt      # Format code
task vet      # Run go vet
task tidy     # Tidy dependencies
task clean    # Remove build artifacts

许可证

麻省理工学院