MCP开发工具

Name: MCP开发工具
Author: DXHeroes

作者：DXHeroes13 星标更新：2025-03-11

安装使用来源：spider==github.com

项目介绍

MCP DevTools

MCP (Model Context Protocol) DevTools 是一组允许AI助手通过模型上下文协议与外部工具和服务交互的软件包集合。

✨ 特点

🔌 无缝集成：连接AI助手到外部服务和工具
🛠 可扩展框架：轻松创建新的模型上下文协议集成
🔍 强大的交互：使AI能够访问并操作来自外部服务的数据
📊 健壮的集成：全面的功能支持Jira和Linear
🚀 开发者友好：简单设置，详细的文档提供最佳的开发者体验

注意：此项目目前处于测试阶段（0.x.x版本）。在测试期间，API可能会在次要版本之间发生变化。

📦 可用的软件包

软件包	描述	状态
@mcp-devtools/jira	Jira MCP服务器集成
@mcp-devtools/linear	Linear MCP服务器集成

🚀 快速开始

在Cursor IDE中的配置

Jira 集成

打开Cursor设置 → MCP
点击“添加新MCP服务器”
填写以下信息：
- 名称：Jira
- 类型：command
- 命令： env JIRA_URL=https://[YOUR_WORKSPACE].atlassian.net JIRA_API_MAIL=[YOUR_EMAIL] JIRA_API_KEY=[YOUR_API_KEY] npx -y @mcp-devtools/jira

必需的环境变量：

JIRA_URL：您的Jira实例URL（例如，https://your-company.atlassian.net）

JIRA_API_MAIL：您的Atlassian账户电子邮件

JIRA_API_KEY：您的Atlassian API密钥（在这里创建一个）

Linear 集成

打开Cursor设置 → MCP
点击“添加新MCP服务器”
填写以下信息：
- 名称：Linear
- 类型：command
- 命令： env LINEAR_API_KEY=[YOUR_API_KEY] npx -y @mcp-devtools/linear

必需的环境变量：

LINEAR_API_KEY：您的Linear API密钥（在Linear应用中创建一个：设置 → API → 创建密钥）

使用工具

一旦配置完成，您可以通过自然语言命令在Cursor中与工具进行交互。

Jira 示例：

# 获取特定工单
get ticket SCRUM-123

# 搜索工单
execute jql "project = SCRUM AND status = 'In Progress'"

# 获取工单详情
read ticket SCRUM-123

# 创建新的工单
create ticket project=SCRUM summary="修复登录错误" description="用户无法登录" issuetype=Bug

Linear 示例：

# 获取特定问题
get_issue SS-33

# 搜索问题
search_issues "优先级是高" with limit 5

# 创建新的问题
create_issue for team "eng" titled "修复API响应格式" with description "API返回了不正确的数据格式" and priority 1

# 列出团队
list_teams

完整的可用命令列表，请参阅软件包文档：

📖 文档

🧩 仓库结构

mcp-devtools/
├── core/                 # 基础设施和实用程序包
│   ├── typescript-config/  # 共享的TypeScript配置
│   └── http-client/        # HTTP客户端实用程序
│
├── packages/             # 功能性的MCP服务器包
│   ├── jira/               # Jira集成MCP服务器
│   │   └── README.md         # 包文档
│   └── linear/             # Linear集成MCP服务器
│       └── README.md         # 包文档
│
└── ...

🛠 开发

# 安装依赖
pnpm install

# 构建所有包
pnpm build

# 开发模式自动重建
pnpm dev

🤝 贡献

欢迎贡献！请查看我们的贡献指南以获取详细信息。

📄 许可证

本项目采用MIT许可证 - 详情见LICENSE文件。

🆘 支持

GitHub Issues：用于报告错误和提出功能请求
讨论：用于提问和社区支持

项目结构

mcp-devtools/
├── core/ # 基础设施和实用程序包
│ ├── typescript-config/ # 共享的TypeScript配置
│ └── http-client/ # HTTP客户端实用程序
│
├── packages/ # 功能性的MCP服务器包
│ ├── jira/ # Jira集成MCP服务器
│ └── linear/ # Linear集成MCP服务器
├── package.json # 根包配置
└── pnpm-workspace.yaml # 工作区配置

开发

开始

此仓库使用pnpm工作区进行包管理。要开始：

如果没有安装pnpm，请先安装：
```
npm install -g pnpm
```
安装依赖：
```
pnpm install
```
构建所有包：
```
pnpm build
```

开发流程

开发模式自动重建：

pnpm dev

发布到NPM

此仓库已设置自动化发布管理，使用release-please和GitHub Actions将包发布到npmjs.org。

测试状态

所有发布的包目前处于测试状态（0.x.x版本），并使用betanpm标签。在此阶段：

次要版本更新可能有重大变更
使用以下命令安装包：npm install @mcp-devtools/package-name@beta
当项目达到稳定时，我们将发布1.0.0版本

调试

由于MCP服务器通过stdio通信，调试可能具有挑战性。我们推荐使用MCP Inspector，它作为工作区脚本提供：

pnpm inspector

Inspector将提供一个URL，以便您可以在浏览器中访问调试工具。

贡献

分叉仓库
创建功能分支 (git checkout -b feature/amazing-feature)
提交更改 (git commit -m '添加一些惊人的功能')
推送到分支 (git push origin feature/amazing-feature)
打开拉取请求

常规提交

此项目使用常规提交来自动化版本控制和变更日志生成。请按照以下模式格式化您的提交消息：

<类型>[可选作用域]: <描述>

[可选正文]

[可选脚注]

类型：

feat：新功能
fix：修复错误
docs：文档更改
style：不影响代码含义的更改（格式化等）
refactor：既不修复错误也不添加功能的代码更改
perf：性能改进
test：添加或修复测试
chore：构建过程或辅助工具的更改

示例：

feat(jira): 添加评论创建端点
fix(http-client): 解决超时问题
docs: 更新README以包含新的设置说明

重大变更应通过在类型/作用域后添加感叹号并在提交消息正文中描述重大变更来指示：

feat!: 重新设计http-client API

重大变更：http-client API已被完全重新设计以提高易用性。

许可证

本项目采用MIT许可证 - 详情见LICENSE文件。

故障排除

常见问题

连接问题
- 确保您的API凭证正确
- 检查到您的服务实例的网络连接
- 验证URL和工作区名称
权限错误
- 确保您的账户具有执行尝试操作所需的适当权限
- API令牌可能需要在您的账户设置中启用特定权限
命令未找到
- 如果使用npx，请确保连接到npm注册表
- 对于本地安装，请检查包安装是否成功

更多故障排除帮助，请在我们的GitHub存储库上打开一个问题。

发展路线图

未来MCP DevTools的发展计划包括：

额外的服务集成（GitHub、Confluence等）
增强的安全特性
支持自定义认证方法
扩展查询能力
性能优化

社区和支持

GitHub Issues：用于报告错误和提出功能请求
讨论：用于提问和社区支持
贡献：请参阅上面的贡献指南

我们欢迎来自社区的反馈和贡献，以帮助改进这些工具。