MCP Devtools

🚀 MCP 開發工具

MCP 開發工具是一個強大的開發平臺，用於集成和管理各類服務。它支持多種常見工具，能有效簡化與不同服務的交互流程，提升開發效率。

🚀 快速開始

啟動開發環境

運行以下命令啟動開發環境：

pnpm dev

打包構建

若要進行打包構建，可使用此命令：

pnpm build

✨ 主要特性

• 多服務集成：支持 Jira、禪道、Trello 和 Slack 等多種服務，滿足不同場景下的項目管理與溝通需求。
• 核心組件共享：提供 typescript-config 共享 TypeScript 配置文件，以及 http-client 用於與外部服務進行 HTTP 通信。

📦 安裝指南

克隆倉庫

使用以下命令克隆項目倉庫並進入項目目錄：

git clone git@github.com:modelcontextprotocol/mcp-devtools.git
cd mcp-devtools

依賴管理

本項目採用 pnpm 進行依賴管理，按以下步驟操作：

1. 若尚未安裝 pnpm，可使用以下命令進行安裝：

   npm install -g pnpm
   

2. 安裝項目依賴：

   pnpm install
   

💻 使用示例

基礎用法

Jira 集成

通過 jira 模塊，可在 MCP 開發工具中創建、更新和查詢任務：

import { JiraClient } from '@mcp-devtools/jira';

const jira = new JiraClient({
  host: 'https://your-domain.atlassian.net',
  token: 'your-api-token'
});

// 創建新任務
await jira.createIssue({
  projectKey: 'YOUR_PROJECT_KEY',
  summary: '完成用戶故事開發',
  description: '需要實現用戶故事功能模塊',
  priority: '高'
});

禪道 集成

禪道模塊允許直接與禪道項目進行交互：

import { ZentaoClient } from '@mcp-devtools/zentao';

const zentao = new ZentaoClient({
  host: 'http://zentao.example.com',
  username: 'your-username',
  password: 'your-password'
});

// 獲取所有項目
const projects = await zentao.getProjectList();

Trello 集成

Trello 模塊提供對 Trello 看板的全面支持：

import { TrelloClient } from '@mcp-devtools/trello';

const trello = new TrelloClient({
  apiKey: 'your-trello-api-key',
  secretKey: 'your-trello-secret-key'
});

// 創建新看板
await trello.createBoard('開發計劃');

Slack 集成

Slack 模塊允許從 MCP 開發工具直接發送消息到指定頻道：

import { SlackClient } from '@mcp-devtools/slack';

const slack = new SlackClient({
  token: 'your-slack-token'
});

// 發送消息到 #開發頻道
await slack.postMessage('開發頻道', '新任務已創建，請注意查收。');

📚 詳細文檔

核心組件

• typescript-config：共享 TypeScript 配置文件，方便項目統一配置。
• http-client：用於與外部服務進行 HTTP 通信的工具，簡化網絡請求操作。

貢獻指南

提交問題

可在 GitHub 上報告錯誤或提出功能請求。

參與討論

加入社區討論，分享您的想法和建議。

代碼貢獻流程

1. Fork 倉庫：

   git clone https://github.com/your-username/mcp-devtools.git
   cd mcp-devtools
   

2. 創建功能分支：

   git checkout -b feature/amazing-feature
   

3. 提交代碼變更：

   git add . && git commit -m '添加令人驚歎的功能'
   

4. 推送到遠程倉庫：

   git push origin feature/amazing-feature
   

5. 創建 Pull Request。

遵循 Conventional Commits

提交 commits 時請按照以下格式：

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

類型包括：

• feat：新功能
• fix：修復錯誤
• docs：文檔變更
• style：代碼風格調整
• refactor：代碼重構
• perf：性能優化
• test：測試相關變更
• chore：構建或其他輔助工具的變更

問題排查

常見問題

1. 連接問題：
   • 確保 API 憑據正確無誤。
   • 檢查網絡連通性。
   • 核對服務地址是否正確。
2. 權限問題：
   • 確認 API 令牌擁有足夠的權限。
   • 查看文檔確認所需權限範圍。
3. 依賴衝突：
   • 使用 pnpm install 重新安裝依賴。
   • 檢查 package.json 文件，確保依賴版本兼容。

調試工具

• 使用 console.log 輸出調試信息。
• 在 Chrome 開發者工具中使用網絡監視器跟蹤 API 請求。

📄 許可證

本項目遵循 MIT 許可證，具體內容請參考 LICENSE 文件。

MCP 開發工具旨在為您提供一個強大而靈活的平臺，簡化與各種服務的集成與管理。歡迎加入我們的社區，共同推動項目的發展！