Metadata-Version: 2.4
Name: gvhmr-mcp
Version: 0.1.0
Summary: GVHMR MCP Server - motion capture tool for AI agents
Author: GVHMR Team
License-Expression: MIT
Project-URL: Homepage, https://github.com/your-org/gvhmr-mcp
Project-URL: Source, https://github.com/your-org/gvhmr-mcp
Project-URL: Documentation, https://github.com/your-org/gvhmr-mcp
Keywords: mcp,motion-capture,gvhmr,smpl,3d-human,ai
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Multimedia :: Video
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastapi>=0.104.0
Requires-Dist: uvicorn[standard]>=0.24.0
Requires-Dist: requests>=2.31.0
Requires-Dist: python-multipart>=0.0.6

# GVHMR MCP Server

MCP (Model Context Protocol) 服务器，为 AI Agent（VS Code Copilot、Claude Desktop 等）提供 3D 人体运动捕捉能力。

## 安装

```bash
# 从 PyPI 安装（发布后）
pip install gvhmr-mcp

# 或从源码安装
cd mcp_server
uv sync
```

## 快速开始

### Stdio 模式（推荐，供 VS Code / Claude Desktop 使用）

```bash
uv run gvhmr-mcp
```

### HTTP 模式（供 Docker 部署）

```bash
uv run gvhmr-mcp-http --port 8001
```

## VS Code 配置

在 `.vscode/mcp.json` 中添加：

```json
{
    "mcpServers": {
        "gvhmr-motion": {
            "command": "uv",
            "args": ["run", "--directory", "/path/to/mcp_server", "gvhmr-mcp"],
            "env": {
                "MOTION_SERVICE_URL": "http://localhost:8000"
            }
        }
    }
}
```

## 可用工具

| 工具 | 说明 |
|------|------|
| `gvhmr_health` | 检查 motion 服务状态 |
| `gvhmr_mocap_async` | 异步提交视频动捕，需提供 `callback_url`，结果会 POST 回该地址 |
| `gvhmr_job_status` | 查询任务状态 |
| `gvhmr_download` | 下载结果文件 |

## 环境变量

| 变量 | 默认值 | 说明 |
|------|--------|------|
| `MOTION_SERVICE_URL` | `http://localhost:8000` | 后端 motion 服务地址 |
| `MCP_PORT` | `8001` | HTTP 模式端口 |

## 构建发布包

```bash
uv build
# 生成的 wheel 在 dist/
```

## 许可证

MIT
