fast-h3yun

Log in with your own H3Yun account and turn the apps, forms, and records in the web workbench into FastMCP tools. Use them for queries from Cursor, OPC Feed, or other MCP clients.

This is not an official H3Yun product, nor the official OpenAPI. The session comes from web login: phone number + password → JWT + EngineCode. What you can see depends on the permissions of the logged-in user.

What it can do

First version is read-only: no create, modify, delete, or approval.

Related MCP server: Feishu Bitable MCP Server

Getting started

Requires Python 3.12+ and uv. It is recommended to use a read-only H3Yun account with narrowed permissions.

git clone https://github.com/ironfrancis/fast-h3yun.git
cd fast-h3yun
cp .env.example .env
uv sync --extra dev
uv run fast-h3yun

Default address: http://127.0.0.1:8765/mcp

You can prefill H3YUN_MOBILE / H3YUN_PASSWORD in .env. It can also start without them; after connecting, call h3yun_login first.

Connecting to an MCP client

{
  "mcpServers": {
    "h3yun": {
      "url": "http://127.0.0.1:8765/mcp"
    }
  }
}

OPC Feed goes through mcp_connection_parse → probe → propose. For Cursor, configure the same URL in the MCP settings. Keep the account and password in this service; do not write them into the client repository.

Environment variables

Limitations

• The web /v1 has no official stability guarantee; H3Yun releases may change fields.

• Too many wrong password attempts will lock the account; this service caches the token and rate-limits login.

• Online password login may trigger an Alibaba Cloud captcha. For unattended use, switch to an already-logged-in H3YUN_TOKEN + H3YUN_ENGINE_CODE from the browser.

• The MCP service itself does not authenticate callers. By default it only listens on localhost; do not expose the port to the public internet.

• Do not commit .env, tokens, or EngineSecret. Tool return values strip password / token.

uv run pytest

License

MIT. Feel free to check out CONTRIBUTING.md and SECURITY.md.