gvhmr-mcp 0.1.0

GVHMR MCP Server - motion capture tool for AI agents

GVHMR MCP Server

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

安装

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

# 或从源码安装
cd mcp_server
uv sync

快速开始

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

uv run gvhmr-mcp

HTTP 模式（供 Docker 部署）

uv run gvhmr-mcp-http --port 8001

VS Code 配置

在 .vscode/mcp.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 模式端口

构建发布包

uv build
# 生成的 wheel 在 dist/

许可证

MIT