AI导哈

AI工具集成开发套件

MCP DevTools是一个通过Model Context Protocol实现AI助手与外部工具和服务交互的开发套件，支持Jira和Linear等服务的集成。

  • by DXHeroes
  • TypeScript
  • 本地部署
  • 13 星标
  • 更新于
在 GitHub 查看 dxheroes/mcp-devtools

使用说明

MCP工具

MCP（模型上下文协议）DevTools是一组包的集合，使AI助手能够通过模型上下文协议与外部工具和服务进行交互。

✨ 亮点

  • 🔌 无缝集成：将人工智能助手连接到外部服务和工具
  • 🛠 可扩展框架：轻松创建与模型上下文协议的新集成
  • 🔍 强大的互动：使人工智能能够访问和操纵来自外部服务的数据
  • 📊 强大的集成：Jira和Linear的全面功能
  • 🚀 开发者友好：简单的设置和详细的文档，以获得最佳的开发人员体验

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

📦 可用包

包 描述 状态
@mcp开发工具/jira Jira MCP服务器集成
@mcp开发工具/线性 线性MCP服务器集成

🚀 快速开始

Cursor IDE中的配置

Jira集成

  1. 打开光标设置→ MCP
  2. 点击“添加新MCP服务器”
  3. 填写以下详细信息：
    • 名字: 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密钥(在此处创建一个)

线性积分

  1. 打开光标设置→ MCP
  2. 点击“添加新MCP服务器”
  3. 填写以下详细信息：
    • 名字: 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工作区进行包管理。开始：

  1. 如果没有，请安装pnpm：

    npm install -g pnpm

  2. 安装依赖项：

    pnpm install

  3. 构建所有包：

    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，用于访问浏览器中的调试工具。

贡献

  1. 分叉存储库
  2. 创建要素分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

常规承诺

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

<type>[optional scope]: <description>

[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许可证获得许可-请参阅 许可证 文件以获取详细信息。

故障排除

常见问题

  1. 连接问题

    • 确保您的API证书正确无误
    • 检查服务实例的网络连接
    • 验证URL和工作区名称

  2. 权限错误

    • 确保您的帐户对您尝试的操作具有适当的权限
    • API令牌可能需要在您的帐户设置中启用特定权限

  3. 未找到命令

    • 如果使用npx，请确保您已连接到npm注册表
    • 对于本地安装，请检查您的软件包安装是否成功

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

路线图

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

  • 其他服务集成（GitHub、Confluence等）
  • 增强的安全功能
  • 支持自定义身份验证方法
  • 扩展查询功能
  • 性能优化

社区与支持

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

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

相关 MCP