{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_rq53n7wdqst6","handle":"mcp-hand-detection","url":"https://wellknown.network/agents/mcp-hand-detection","links":{"self":"https://wellknown.network/agents/mcp-hand-detection/record.json","html":"https://wellknown.network/agents/mcp-hand-detection","markdown":"https://wellknown.network/agents/mcp-hand-detection/record.md","api":"https://wellknown.network/api/v1/agents/mcp-hand-detection","status":"https://wellknown.network/api/v1/agents/mcp-hand-detection/status","claim":"https://wellknown.network/agents/mcp-hand-detection/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-hand-detection/claim.json","badge":"https://wellknown.network/agents/mcp-hand-detection/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-hand-detection/history","tools":"https://wellknown.network/api/v1/agents/mcp-hand-detection/tools"},"ard":{"identifier":"urn:air::server:mcp-hand-detection","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-hand-detection","summary":"MCP Hand Detection - 基于 MediaPipe 的手掌检测 MCP 服务","description":"# MCP Hand Detection\n\n一个基于 MediaPipe 的 Model Context Protocol (MCP) 服务器，提供手掌检测功能。\n\n## 功能特性\n\n- ✅ 基于 MediaPipe 的高精度手掌检测\n- ✅ 符合 MCP 标准协议（JSON-RPC 2.0）\n- ✅ 支持 stdio 和 HTTP 两种接口\n- ✅ 易于集成到支持 MCP 的客户端（如 Cursor、Claude Desktop）\n- ✅ 包含预训练模型，开箱即用\n\n## 安装\n\n```bash\npip install mcp-hand-detection\n```\n\n如果需要 HTTP API 功能：\n\n```bash\npip install mcp-hand-detection[http]\n```\n\n## 快速开始\n\n### 作为 MCP 服务器使用\n\n在 MCP 客户端配置中添加：\n\n```json\n{\n  \"mcpServers\": {\n    \"hand-detection\": {\n      \"command\": \"mcp-hand-detection\"\n    }\n  }\n}\n```\n\n### 作为命令行工具使用\n\n```bash\n# 启动 MCP 服务器（通过 stdio）\nmcp-hand-detection\n\n# 启动 HTTP 服务器\nmcp-hand-detection-http --port 8080\n```\n\n### 作为 Python 库使用\n\n```python\nfrom mcp_hand_detection import MCPServer\n\n# 创建服务器实例\nserver = MCPServer()\n\n# 检测手掌\nresult = server._detect_hand(\"/path/to/image.jpg\")\nprint(result)\n```\n\n### HTTP API 使用示例\n\n```python\nfrom mcp_hand_detection import create_app\n\napp = create_app()\napp.run(host='0.0.0.0', port=8080)\n```\n\n或者使用命令行：\n\n```bash\nmcp-hand-detection-http --host 0.0.0.0 --port 8080\n```\n\n然后通过 HTTP 调用：\n\n```bash\n# 文件上传\ncurl -X POST http://localhost:8080/api/detect -F \"image=@hand.jpg\"\n\n# Base64 编码\ncurl -X POST http://localhost:8080/api/detect \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"image_base64\": \"...\", \"image_format\": \"jpg\"}'\n```\n\n## API 文档\n\n### MCP 工具\n\n- **工具名称**: `detect_hand`\n- **描述**: 检测图片中是否存在手掌\n- **参数**:\n  - `image_path` (string, 必需): 图片文件路径\n- **返回**: JSON 格式的检测结果\n\n### HTTP API\n\n- `GET /health` - 健康检查\n- `GET /api/tools` - 获取工具列表\n- `POST /api/detect` - 检测手掌\n  - 支持文件上传 (`multipart/form-data`)\n  - 支持 Base64 编码 (`application/json`)\n\n## 系统要求\n\n- Python 3.9+\n- OpenCV\n- MediaPipe 0.10+\n- NumPy\n\n## 许可证\n\nMIT License\n\n## 贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n## 链接\n\n- [GitHub Repository](https://github.com/yourusername/mcp-hand-detection)\n- [PyPI Package](https://pypi.org/project/mcp-hand-detection/)","publisher":{"name":"QianShun","url":null},"homepage":null,"repository":null,"version":"1.0.1","license":null,"protocols":["mcp"],"tags":["mcp","mediapipe","hand","detection","computer","vision","ai"],"pricing":null,"endpoints":[{"url":"pypi:mcp-hand-detection","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"media.image-understanding","name":"Image Understanding","confidence":1,"provenance":"declared"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev","media"],"language":"fr"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-hand-detection","registry":"pypi","observedAt":"2026-10-22T09:23:36.863Z","publishedAt":"2026-01-03T17:19:28.248333Z","latestVersion":"1.0.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-hand-detection","url":"https://pypi.org/project/mcp-hand-detection/","firstSeenAt":"2026-09-10T02:22:37.958Z","fetchedAt":"2026-10-22T09:22:09.089Z","normalizedAt":"2026-10-22T09:22:09.089Z"}]},"firstSeenAt":"2026-09-10T02:22:37.958Z","updatedAt":"2026-10-22T09:23:36.864Z"}