youling-agent-mcp/README.md

MCP服务器实现POMDP研发任务拆解

# POMDP MCP服务器

基于MCP协议实现的研发任务POMDP拆解服务器。该服务接收自然语言形式的任务描述，通过POMDP（部分可观察马尔可夫决策过程）方法对研发任务进行系统化拆解，返回详细的研发方案。

## 功能特点

- 基于MCP (Model Context Protocol) 协议实现
- 使用POMDP方法进行任务拆解
- RESTful API接口
- 支持客户端-服务器交互模式

## 项目结构

```
pomdp-mcp-server/
├── src/
│   ├── mcp-server.ts       # MCP服务器实现
│   ├── pomdp-decomposer.ts # POMDP任务分解逻辑
│   ├── types.ts            # 类型定义
│   ├── mcp-sdk.d.ts        # MCP SDK类型声明
│   └── test-client.ts      # 测试客户端
├── .env                    # 环境变量配置
├── package.json            # 项目配置
└── tsconfig.json           # TypeScript配置
```

## 安装和设置

1. 克隆项目仓库
2. 安装依赖
```bash
npm install
```
3. 编辑`.env`文件，设置必要的环境变量
```
PORT=3000
MCP_SECRET_KEY=your_secret_key_here
```

## 使用方法

### 启动服务器
```bash
npm run dev  # 使用ts-node开发模式运行
# 或
npm run build
npm start    # 运行编译后的JavaScript
```

### 测试客户端
```bash
npm run test-client
```

## API接口

### 初始化请求
```
POST /mcp/initiate
{
  "resourceType": "pomdp-task-decomposer",
  "question": "任务描述文本"
}
```

### 资源请求
```
POST /mcp/resource
{
  "resourceType": "pomdp-task-decomposer",
  "question": "任务描述文本"
}
```

## 输出格式

服务器返回Markdown格式的研发方案，包含以下内容：

1. 项目概述
2. 开发阶段
3. 阶段依赖关系
4. 风险管理
5. 时间估计
6. 结论

## 注意事项

- 当前实现是基础版本，实际应用中应该包含更复杂的POMDP模型和算法
- 需要确保MCP SDK已正确安装和配置