手

手掌监测MCP

QianShun333/hand-detection-mcp

0 Stars 15 次浏览更新于 2026-08-23

其他

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "mcp-hand-detection": {
      "args": [
        "mcp-hand-detection@latest"
      ],
      "command": "uvx",
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

服务介绍

MCP Hand Detection

一个基于 MediaPipe 的 Model Context Protocol (MCP) 服务器，提供手掌检测功能。

功能特性

✅ 基于 MediaPipe 的高精度手掌检测
✅ 符合 MCP 标准协议（JSON-RPC 2.0）
✅ 支持 stdio 和 HTTP 两种接口
✅ 易于集成到支持 MCP 的客户端（如 Cursor、Claude Desktop）
✅ 包含预训练模型，开箱即用

安装

pip install mcp-hand-detection

如果需要 HTTP API 功能：

pip install mcp-hand-detection[http]

快速开始

作为 MCP 服务器使用

在 MCP 客户端配置中添加：

{
  "mcpServers": {
    "hand-detection": {
      "command": "mcp-hand-detection"
    }
  }
}

作为命令行工具使用

# 启动 MCP 服务器（通过 stdio）
mcp-hand-detection

# 启动 HTTP 服务器
mcp-hand-detection-http --port 8080

作为 Python 库使用

from mcp_hand_detection import MCPServer

# 创建服务器实例
server = MCPServer()

# 检测手掌
result = server._detect_hand("/path/to/image.jpg")
print(result)

HTTP API 使用示例

from mcp_hand_detection import create_app

app = create_app()
app.run(host='0.0.0.0', port=8080)

或者使用命令行：

mcp-hand-detection-http --host 0.0.0.0 --port 8080

然后通过 HTTP 调用：

# 文件上传
curl -X POST http://localhost:8080/api/detect -F "image=@hand.jpg"

# Base64 编码
curl -X POST http://localhost:8080/api/detect \
  -H "Content-Type: application/json" \
  -d '{"image_base64": "...", "image_format": "jpg"}'

API 文档

MCP 工具

工具名称: detect_hand
描述: 检测图片中是否存在手掌
参数:
- image_path (string, 必需): 图片文件路径
返回: JSON 格式的检测结果

HTTP API

GET /health - 健康检查
GET /api/tools - 获取工具列表
POST /api/detect - 检测手掌
- 支持文件上传 (multipart/form-data)
- 支持 Base64 编码 (application/json)

系统要求

Python 3.9+
OpenCV
MediaPipe 0.10+
NumPy

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request！

链接

查看源码项目主页