MCP 服务器

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

🚀 特性

• 多工具集成: 支持多种工具集成的模块化架构
• 类型安全: 完整的 TypeScript 支持，带有 Zod 模式验证
• ESM 支持: 现代 ES 模块实现
• 可扩展: 易于添加新工具和集成

📦 当前工具

JIRA 集成

• 创建具有可自定义字段的问题
• 自动响应格式化
• 问题创建的模式验证

TODO 管理

• 创建具有优先级和截止日期的 TODO
• 灵活的模式支持可选字段
• 格式化的响应消息

🛠 项目结构

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 NEW_TOOL = {
  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: "New Tool",
  version: "1.0.0",
  tools: [
    {
      name: NEW_TOOL.ACTION,
      schema: newToolSchema,
      handler: handleAction,
    },
  ],
};

🔄 开发工作流程

1. 创建功能分支
2. 实现更改
3. 运行测试 (如果已实现)
4. 构建项目
5. 提交 PR

📝 注意

• 使用 ES 模块以获得更好的模块化
• 实现 Model Context Protocol 以进行标准化通信
• 遵循 TypeScript 最佳实践
• Zod 模式验证以确保类型安全

🛣️ 路线图

• [ ] 添加更多 JIRA 操作
• [ ] 实现 TODO 持久化
• [ ] 添加身份验证
• [ ] 添加测试框架
• [ ] 添加更多集成 (GitHub, Slack 等)

📄 许可证

MIT