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
1 maintainer
Metadata
1 maintainer
Release files for gvhmr-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| gvhmr_mcp-0.1.0.tar.gz | 9.9 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gvhmr_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 23.6 kB
Release files / gvhmr_mcp-0.1.0.tar.gz
| Download URL | gvhmr_mcp-0.1.0.tar.gz |
|---|---|
| Size | 9.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7b3047e5cd19f1e0d63b184ff0f0b850b34c800fab507af353c1b3f611cc177a
|
|
BLAKE2b-256 checksum How to use checksums |
9fc6402f239459ac12148a985a6507f0d7f4360ad087366d2736631b3111a55b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / gvhmr_mcp-0.1.0-py3-none-any.whl
| Download URL | gvhmr_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 13.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
72cf33dc3160d42d92ab85ef250dbd7b0a5f596f4df3a18753beb7a242da702c
|
|
BLAKE2b-256 checksum How to use checksums |
0ee5366bf55dd48f30333e912aacee098acfbdb4c7d302175acf3c5ce25d504d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for gvhmr-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
