MCP工具
MCP（模型上下文协议）DevTools是一组包的集合，使AI助手能够通过模型上下文协议与外部工具和服务进行交互。
✨ 亮点
- 🔌 无缝集成：将人工智能助手连接到外部服务和工具
- 🛠 可扩展框架：轻松创建与模型上下文协议的新集成
- 🔍 强大的互动：使人工智能能够访问和操纵来自外部服务的数据
- 📊 强大的集成：Jira和Linear的全面功能
- 🚀 开发者友好：简单的设置和详细的文档，以获得最佳的开发人员体验
备注：此项目目前处于测试阶段（0.x.x版本）。在测试阶段，API可能会在次要版本之间发生变化。
📦 可用包
| 包 | 描述 | 状态 |
|---|---|---|
| @mcp开发工具/jira | Jira MCP服务器集成 | ](https://www.npmjs.com/package/@mcp-devtools/jira) |
| @mcp开发工具/线性 | 线性MCP服务器集成 | ](https://www.npmjs.com/package/@mcp-devtools/linear) |
🚀 快速开始
Cursor IDE中的配置
Jira集成
- 打开光标设置→ 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密钥(在此处创建一个)
线性积分
- 打开光标设置→ 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示例：
# Fetch a specific ticket
get ticket SCRUM-123
# Search for tickets
execute jql "project = SCRUM AND status = 'In Progress'"
# Get ticket details
read ticket SCRUM-123
# Create a new ticket
create ticket project=SCRUM summary="Fix login bug" description="Users can't log in" issuetype=Bug线性示例：
# Get a specific issue
get_issue SS-33
# Search for issues
search_issues "priority is high" with limit 5
# Create a new issue
create_issue for team "eng" titled "Fix API response format" with description "The API is returning incorrect data format" and priority 1
# List teams
list_teams有关可用命令的完整列表，请参阅软件包文档：
📖 文档
🧩 存储库结构
mcp-devtools/
├── core/ # Infrastructure and utility packages
│ ├── typescript-config/ # Shared TypeScript configuration
│ └── http-client/ # HTTP client utilities
│
├── packages/ # Functional MCP server packages
│ ├── jira/ # Jira integration MCP server
│ │ └── README.md # Package documentation
│ └── linear/ # Linear integration MCP server
│ └── README.md # Package documentation
│
└── ...🛠 发展
# Install dependencies
pnpm install
# Build all packages
pnpm build
# Development with auto-rebuild
pnpm dev🤝 贡献
欢迎投稿！请查看我们的 贡献指南 了解详情。
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🆘 支持
- GitHub问题：用于错误报告和功能请求
- 讨论：用于提问和社区支持
项目结构
mcp-devtools/
├── core/ # Infrastructure and utility packages
│ ├── typescript-config/ # Shared TypeScript configuration
│ └── http-client/ # HTTP client utilities
│
├── packages/ # Functional MCP server packages
│ ├── jira/ # Jira integration MCP server
│ └── linear/ # Linear integration MCP server
├── package.json # Root package configuration
└── pnpm-workspace.yaml # Workspace configuration发展
入门指南
此存储库使用pnpm工作区进行包管理。开始：
- 如果没有，请安装pnpm：
npm install -g pnpm- 安装依赖项：
pnpm install- 构建所有包：
pnpm build开发工作流程
对于自动重建的开发：
pnpm dev向NPM发布
此存储库使用releaseplease和GitHub Actions进行自动发布管理，用于将包发布到npmjs.org。
Beta状态
所有已发布的软件包当前都处于测试状态（0.x.x版本），并使用 beta npm标签。在此阶段：
- 次要版本更新中可能会发生重大更改
- 使用以下方式安装软件包：
npm install @mcp-devtools/package-name@beta - 当项目达到稳定状态时，我们将发布1.0.0版本
调试
由于MCP服务器通过stdio进行通信，调试可能具有挑战性。我们建议使用 MCP检查员，可作为工作区脚本使用：
pnpm inspector检查器将提供一个URL，用于访问浏览器中的调试工具。
贡献
- 分叉存储库
- 创建要素分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add some amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
常规承诺
此项目使用 常规承诺 自动化版本控制和变更日志生成。请按照以下模式格式化您的提交消息：
[optional scope]:
[optional body]
[optional footer(s)]类型：
feat：新功能fix：错误修复docs：文件更改style：不影响代码含义的更改（格式等）refactor：既不修复错误也不添加功能的代码更改perf：性能改进test：添加或修复测试chore：对构建过程或辅助工具的更改
示例：
feat(jira): add comment creation endpoint
fix(http-client): resolve timeout issue
docs: update README with new setup instructions应在类型/范围后添加一个感叹号，并在提交消息的正文中描述突破性更改，以指示突破性更改：
feat!: redesign http-client API
BREAKING CHANGE: The http-client API has been completely redesigned to improve usability.许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
故障排除
常见问题
- 连接问题
- 确保您的API证书正确无误 - 检查服务实例的网络连接 - 验证URL和工作区名称
- 权限错误
- 确保您的帐户对您尝试的操作具有适当的权限 - API令牌可能需要在您的帐户设置中启用特定权限
- 未找到命令
- 如果使用npx，请确保您已连接到npm注册表 - 对于本地安装，请检查您的软件包安装是否成功
如需更多故障排除帮助，请在我们的GitHub存储库上打开问题。
路线图
MCP DevTools的未来开发计划包括：
- 其他服务集成（GitHub、Confluence等）
- 增强的安全功能
- 支持自定义身份验证方法
- 扩展查询功能
- 性能优化
社区与支持
- GitHub问题：用于错误报告和功能请求
- 讨论：用于提问和社区支持
- 贡献：请参阅上面的投稿指南
我们欢迎社区的反馈和贡献，以帮助改进这些工具。