Jira & Linear

🚀 MCP 开发工具

MCP 开发工具是一套用于与 Model Context Protocol（MCP）协议交互的开发服务器，能帮助开发者轻松集成和管理如 Jira、Trello 和 Confluence 等各类服务。

🚀 快速开始

MCP 开发工具可助力开发者高效与 MCP 协议交互。以下为您介绍使用前的准备工作。

✨ 主要特性

核心组件

• typescript-config：共享 TypeScript 配置文件。
• http-client：提供 HTTP 客户端功能。

功能包

• jira：与 Jira 服务集成，支持任务、问题和评论的创建。
• linear：与 Linear 管理工具交互。

📦 安装指南

使用 pnpm 进行管理，具体步骤如下：

1. 安装 pnpm：

   npm install -g pnpm
   

2. 安装项目依赖：

   pnpm install
   

3. 构建所有包：

   pnpm build
   

💻 使用示例

基础用法

所有 MCP 服务器通过标准输入/输出进行通信。默认情况下，服务会监听以下端口：

• stdin：用于接收来自代理的请求。
• stdout：发送响应或日志信息。

// 启动一个 MCP 服务器
const server = new MCP.Server({
    name: 'my-server',
    version: '1.0.0'
});

server.on('request', (request, response) => {
    // 处理请求逻辑
    response.send('Hello World!');
});

server.listen();

📚 详细文档

开发流程

调试工具

使用 MCP Inspector 进行调试：

pnpm inspector

启动后，Inspector 会提供一个 URL，用于在浏览器中访问调试工具。

贡献指南

1. Fork 仓库。
2. 创建功能分支：

   git checkout -b feature/amazing-feature
   

3. 提交更改：

   git commit -m '实现新功能'
   

4. 推送到分支：

   git push origin feature/amazing-feature
   

5. 创建 Pull Request。

Conventional Commits 规范

遵循 Conventional Commits 格式，示例提交信息如下：

feat(jira): 增加评论创建功能
fix(http-client): 修复超时问题
docs: 更新 README 中的安装说明

故障排除

常见问题

1. 连接问题：
   • 确保 API 凭证正确。
   • 检查网络连通性。
   • 核对 URL 和工作区名称。
2. 权限错误：
   • 确认账户有适当的权限。
   • 检查 API 令牌是否启用所需权限。
3. 命令未找到：
   • 使用 npx 时，确保连接到 npm 注册表。
   • 检查包安装是否成功。

未来计划

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

欢迎社区反馈和贡献，帮助提升这些工具。

📄 许可证

本项目使用 MIT 许可证，具体内容请查看 LICENSE 文件。