人机交互MCP

Deploy With An Agent

Copy this command, run it anywhere with internet access, then send the fetched prompt to the agent that will deploy humen-mcp on your server:

curl -fsSL https://raw.githubusercontent.com/LIghtJUNction/humen-mcp/main/docs/AGENT_DEPLOY_PROMPT.md

The prompt tells the agent to inspect the server, install the package, configure the site root and /mcp, verify the MCP endpoint, and keep admin secrets out of public output.

<details> <summary><strong>Manual Server Deployment Guide</strong></summary>

This is the short human-run path for an Arch Linux server. See docs/DEPLOYMENT.md for the longer deployment note.

1. Install the package:

```bash paru -S humen-mcp-git

AUR build says it is reading `/root/.git`

Run paru through a login shell for the normal AUR user:

sudo -iu arch bash -lc 'unset GIT_DIR GIT_WORK_TREE; cd ~; paru -S humen-mcp-git'

Community Plugins

Plugins are declarative JSON or TOML manifests loaded at startup from HUMEN_PLUGIN_DIR. A manifest can contribute request templates, route strategies, scoring rules, and third-party channel declarations. The server exposes loaded plugins through list_humen_plugins, and agents can create an async request from a template with create_humen_request_from_template.

Template ids use plugin-id/template-id. Template text supports simple {{variable}} substitution from the tool call's variables object. Plugin authors can use the published humen-mcp-sdk crate to build and validate manifests before distribution.

Example manifest: examples/community-release-plugin.json.

</details>

<details> <summary><strong>HTTP and WebSocket API</strong></summary>

Authenticated UI APIs:

• GET /api/me
• GET /api/me/profile
• POST /api/me/profile
• GET /api/passkeys
• POST /api/passkeys/register/start
• POST /api/passkeys/register/finish
• POST /api/passkeys/{id}/delete
• GET /api/agent/access
• POST /api/agent/secret
• GET /api/requests
• POST /api/requests/{id}/answer
• GET /api/sent
• GET /api/tasks
• POST /api/tasks/{id}/status
• GET /api/trash
• POST /api/trash/clear
• GET /api/users/online
• GET /api/users/search?q=...
• POST /api/humans/rate
• POST /api/humans/report
• GET /api/leaderboard
• GET /api/tags
• GET /api/friends
• POST /api/friends
• POST /api/friends/{email}/accept
• POST /api/friends/{email}/remove
• GET /api/ws

Admin APIs:

• GET /api/admin/users
• POST /api/admin/users
• POST /api/admin/users/{email}
• POST /api/admin/users/{email}/kick
• GET /api/admin/reports
• GET /api/admin/settings
• POST /api/admin/settings
• GET /api/admin/update
• POST /api/admin/update
• GET /api/admin/webhooks
• POST /api/admin/webhooks

WebSocket events:

{ "type": "request_created", "request": {} }
{ "type": "request_answered", "id": "...", "answer": {} }
{ "type": "request_expired", "id": "...", "expired_request": {} }
{ "type": "trash_cleaned", "removed_count": 1 }
{ "type": "presence_changed", "online_count": 1 }

</details>

<details> <summary><strong>Configuration</strong></summary>

env.example documents all supported variables. Important production values:

HUMEN_BIND=127.0.0.1:8787
HUMEN_PUBLIC_BASE_URL=https://your-domain.example
HUMEN_WEB_DIST=/usr/share/humen-mcp/web
HUMEN_USERS_FILE=/var/lib/humen-mcp/users.json
HUMEN_DB_FILE=/var/lib/humen-mcp/humen-mcp.sqlite3
HUMEN_ADMIN_EMAIL=<admin-email>
HUMEN_ADMIN_PASSWORD=<generated-admin-password>
HUMEN_SESSION_SECRET=<generated-session-secret>
HUMEN_TRASH_RETENTION_SECONDS=604800
HUMEN_CLEANUP_INTERVAL_SECONDS=60
HUMEN_SELF_UPDATE_COMMAND=/usr/bin/sudo -n /usr/bin/systemctl start humen-mcp-self-update.service
HUMEN_SELF_UPDATE_TIMEOUT_SECONDS=30
HUMEN_PLUGIN_DIR=/etc/humen-mcp/plugins
HUMEN_NODE_ID=root
HUMEN_FEDERATION_FILE=/etc/humen-mcp/federation.toml

Production note: after AUR install, make sure /etc/humen-mcp.env uses the packaged web directory:

HUMEN_WEB_DIST=/usr/share/humen-mcp/web

If this is left as ./humen-mcp-webui/dist, https://your-domain.example/ will return 404 because the service runs from /var/lib/humen-mcp.

</details>

<details> <summary><strong>Arch Deployment</strong></summary>

Install with an AUR helper as a normal user, not root:

```bash paru -S humen-mcp-git