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 文件。