MCP Servers

MCP 服务

一个基于 TypeScript 的 Model Context Protocol (MCP) 服务实现，为 JIRA 和 TODO 管理等各种服务提供集成工具。

🚀 功能

• 多工具集成：支持多种工具集成的模块化架构
• 类型安全：全面支持 TypeScript，并使用 Zod 进行架构验证
• ESM 支持：采用现代 ES Modules 实现
• 可扩展：轻松添加新工具和集成

📦 当前工具

JIRA 集成

• 使用可自定义字段创建问题
• 自动格式化响应
• 验证问题创建的架构

TODO 管理

• 创建带优先级和截止日期的待办事项
• 灵活的架构支持可选字段
• 格式化响应消息

🛠 项目结构

src/
├── config/           # Tool configurations
│   ├── jira-tool.config.ts
│   └── todo-tool.config.ts
├── constant/         # Constant definitions
│   └── tool-name.ts
├── schema/          # Zod schemas for validation
│   ├── jira.ts
│   └── todo.ts
├── server/          # Server management
│   └── mcp-server-tool-manager.ts
├── tools/           # Tool implementations
│   ├── jira/
│   │   └── create-issue.ts
│   └── todo/
│       └── create-todo.ts
└── index.ts         # Main entry point

🔌 添加新工具

1. 在 constant/tool-name.ts 中定义工具常量
2. 在 schema/ 目录中创建架构
3. 在 tools/ 目录中实现工具处理程序
4. 在 config/ 目录中添加配置
5. 在 index.ts 中注册工具

示例：

// 1. Add constant
export const NEW_TOOL = {
  ACTION: "action_name"
} as const;

// 2. Create schema
export const newToolSchema = z.object({
  // ... schema definition
});

// 3. Implement handler
export const handleAction = async (
  args: z.infer<typeof newToolSchema>,
  extra: RequestHandlerExtra
): Promise<CallToolResult> => {
  // ... implementation
};

// 4. Add configuration
export const newToolConfig = {
  name: "New Tool",
  version: "1.0.0",
  tools: [
    {
      name: NEW_TOOL.ACTION,
      schema: newToolSchema,
      handler: handleAction,
    },
  ],
};

🔄 开发工作流

1. 创建功能分支
2. 实现更改
3. 运行测试（实现后）
4. 构建项目
5. 提交 PR

📝 说明

• 使用 ES Modules 提高模块化程度
• 实现 Model Context Protocol，以进行标准化通信
• 遵循 TypeScript 最佳实践
• 使用 Zod 架构验证确保类型安全

🛣️ 路线图

• 添加更多 JIRA 操作
• 实现 TODO 持久化
• 添加身份验证
• 添加测试框架
• 添加更多集成（GitHub、Slack 等）

📄 许可证

MIT