DevSpec MCP Server

DevSpec的MCP (Model Context Protocol) 服务器，为AI助手提供完整的DevSpec功能访问。

功能特性

• 🔧 完整的DevSpec支持: 支持所有主要DevSpec CLI命令
• 🚀 自动安装: 首次运行时自动安装DevSpec CLI组件
• 📦 即插即用: 支持npx直接运行，无需复杂配置
• 🎯 智能工具选择: 通过详细的工具描述，AI助手能够自动选择合适的工具

安装

方式1: 直接使用npx (推荐)

npx devspec-mcp

方式2: 全局安装

npm install -g devspec-mcp

方式3: 项目内安装

npm install devspec-mcp

使用方法

配置MCP客户端

在你的MCP客户端配置中添加：

{
  "mcpServers": {
    "devspec": {
      "command": "npx",
      "args": ["devspec-mcp"]
    }
  }
}

工具使用场景

项目初始化

当用户提到"初始化"、"开始项目"、"新建DevSpec项目"时，AI会使用 openspec_init 工具。

创建变更提案

当用户需要"创建新功能"、"添加变更提案"、"实现功能需求"时，AI会使用 openspec_create_change 工具。

查看项目信息

当用户需要"查看所有变更"、"列出规格"、"显示项目状态"时，AI会使用 openspec_list 工具。

显示详细信息

当用户需要"查看变更详情"、"显示规格内容"时，AI会使用 openspec_show 工具。

验证项目

当用户需要"检查项目"、"验证变更"、"确保格式正确"时，AI会使用 openspec_validate 工具。

完成变更

当用户提到"完成变更"、"部署功能"、"归档提案"时，AI会使用 openspec_archive 工具。

工具列表

核心工具

1. openspec_init - 初始化DevSpec项目
2. openspec_list - 列出变更或规格
3. openspec_show - 显示详细信息
4. openspec_validate - 验证变更或规格
5. openspec_create_change - 创建变更提案
6. openspec_archive - 归档已完成变更

故障排除

常见问题

1. DevSpec CLI未安装

   • 服务器会在首次运行时自动安装
   • 也可以手动安装：npm install -g devspec

2. 权限问题

   • 确保有全局安装包的权限
   • 或使用 sudo npm install -g devspec

3. 自然语言无法识别

   • 尝试使用更明确的描述
   • 或使用具体的工具命令

贡献

欢迎提交Issue和Pull Request！

许可证

MIT License

相关链接

• DevSpec官方文档
• MCP协议文档
• Model Context Protocol SDK