# lang_task_mcp_server

**Repository Path**: wanjian325/lang_task_mcp_server

## Basic Information

- **Project Name**: lang_task_mcp_server
- **Description**: 一个长时任务的mcp server示例
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-03
- **Last Updated**: 2026-03-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Long Task MCP Server (FastMCP)

这是一个基于 FastMCP 的长时任务示例服务，采用“提交任务 + 查询状态/结果”的模式，避免单次 tool 调用阻塞。

## Tools

- `start_task(duration_seconds=30, label="default")`
  - 立即返回 `task_id`
- `get_task_status(task_id)`
  - 返回当前状态、进度、时间戳
- `get_task_result(task_id)`
  - 完成后返回结果；未完成返回当前状态
- `cancel_task(task_id)`
  - 取消任务

## 快速开始

```bash
python -m venv .venv
source .venv/bin/activate
pip install -e .
python -m src.server
```

## VS Code 调试

项目已包含 `.vscode/launch.json` 与 `.vscode/settings.json`。

直接在 VS Code 运行 **Debug: Run MCP Server** 即可。