Modular Tool Framework (Jira & Todo)

🚀 MCP 服務器

MCP 服務器是一個基於 TypeScript 的 Model Context Protocol (MCP) 服務器實現，它作為一款集成工具，可提供多種服務，如 JIRA 和待辦事項管理等，有效解決了不同工具集成使用的問題，提升了工作效率和管理的便捷性。

🚀 快速開始

MCP 服務器為用戶提供了便捷的多工具集成服務，以下將詳細介紹其相關內容。

✨ 主要特性

• 多工具集成：採用模塊化架構，能夠輕鬆支持多種工具的集成。
• 類型安全：具備全面的 TypeScript 支持，並配合 Zod 模式驗證，確保代碼的類型安全性。
• ESM 支持：基於現代 ES 模塊實現，符合當下的技術發展趨勢。
• 可擴展：允許用戶輕鬆添加新的工具和集成，滿足多樣化的需求。

📦 安裝指南

文檔未提供具體安裝步驟，暫無法展示。

📦 當前工具

JIRA 集成

• 可使用自定義字段創建問題。
• 能對響應進行自動格式化。
• 對問題創建進行模式驗證。

待辦事項管理

• 支持創建帶有優先級和截止日期的待辦事項。
• 擁有靈活的模式，支持可選字段。
• 可格式化響應消息。

🛠 項目結構

src/
├── config/           # 工具配置
│   ├── jira-tool.config.ts
│   └── todo-tool.config.ts
├── constant/         # 常量定義
│   └── tool-name.ts
├── schema/          # Zod 模式驗證
│   ├── jira.ts
│   └── todo.ts
├── server/          # 服務器管理
│   └── mcp-server-tool-manager.ts
├── tools/           # 工具實現
│   ├── jira/
│   │   └── create-issue.ts
│   └── todo/
│       └── create-todo.ts
└── index.ts         # 主入口點

🔌 新工具的添加

1. 在 constant/tool-name.ts 中定義工具常量。
2. 在 schema/ 目錄中創建模式。
3. 在 tools/ 目錄中實現工具處理程序。
4. 在 config/ 目錄中添加配置。
5. 在 index.ts 中註冊工具。

示例：

// 1. 添加常量
export const 新工具 = {
  ACTION: "action_name"
} as const;

// 2. 創建模式
export const newToolSchema = z.object({
  // ... 模式定義
});

// 3. 實現處理程序
export const handleAction = async (
  args: z.infer<typeof newToolSchema>,
  extra: RequestHandlerExtra
): Promise<CallToolResult> => {
  // ... 實現邏輯
};

// 4. 添加配置
export const newToolConfig = {
  name: "新工具",
  version: "1.0.0",
  tools: [
    {
      name: 新工具.ACTION,
      schema: newToolSchema,
      handler: handleAction,
    },
  ],
};

🔄 開發工作流

1. 創建功能分支。
2. 實施變更。
3. 運行測試（當實現時）。
4. 構建項目。
5. 提交 PR。

📚 詳細文檔

📝 備註

• 建議使用 ES 模塊，以獲得更好的模塊化效果。
• 需實現 Model Context Protocol，以實現標準化通信。
• 應遵循 TypeScript 最佳實踐進行開發。
• 利用 Zod 模式驗證，確保類型安全。

🛣️ 路線圖

• [ ] 添加更多 JIRA 操作。
• [ ] 實現待辦事項持久化。
• [ ] 添加身份驗證。
• [ ] 添加測試框架。
• [ ] 添加更多集成（GitHub、Slack 等）。

📄 許可證

本項目採用 MIT 許可證。