---
name: dev-mcp
description: MCP Bridge 开发插件。TypeScript MCP 服务开发，Token 管理，HTTP 客户端模式。当涉及 mcp-task-bridge 开发时按需加载。
---

# MCP Bridge 开发插件 (dev-mcp)

## 项目结构

```
mcp-task-bridge/
├── index.ts             # 入口，MCP server 注册
├── task-service.ts      # 任务服务
├── document-service.ts  # 文档服务
├── requirement-service.ts # 需求服务
├── base-client.ts       # HTTP 基类（认证、重试）
├── types.ts             # 类型定义
└── token-storage.ts     # Token 持久化
```

## 代码规范

```typescript
export class TaskService extends BaseClient {
    async createTask(
        title: string,
        projectId: number = 1,
        options: CreateTaskOptions = {}
    ): Promise<ApiResponse<Task>> {
        try {
            const response = await this.makeRequest<Task>(
                'POST',
                `/projects/${projectId}/tasks`,
                { title, project_id: projectId, ...options }
            );
            return response.success
                ? { success: true, data: response.data, message: `✅ 任务创建成功` }
                : response;
        } catch (error: any) {
            return { success: false, error: `创建任务失败: ${error.message}` };
        }
    }
}
```

## 关键规则

1. **MCP endpoint 前缀**：所有 MCP 专用后端接口必须包含 `/mcp/` 前缀
2. **修改后重新构建**：`npm run build` → `pkill -f "mcp-task-bridge/dist/index.js"`
3. **环境一致性**：不要跨环境混用数据（dev/staging/prod）

## 常用命令

```bash
npm run dev          # 开发（hot reload）
npm run build        # 编译 TypeScript
npm test             # 快速测试
npm run test:integration  # 集成测试
```