fast-h3yun

Usa tu propia cuenta de 氚云 para iniciar sesión y convierte las aplicaciones, formularios y registros del panel web en herramientas FastMCP. Úsalas para consultas desde Cursor, OPC Feed u otros clientes MCP.

Este no es un producto oficial de 氚云 ni la OpenAPI oficial. La sesión proviene del inicio de sesión web: 手机号 + 密码 → JWT + EngineCode. Lo que se puede ver depende de los permisos del usuario que inicia sesión.

Qué puede hacer

La primera versión es de solo lectura: no crea, modifica, elimina ni aprueba.

Related MCP server: Feishu Bitable MCP Server

Inicio

Requiere Python 3.12+ y uv. Se recomienda usar una cuenta de 氚云 de solo lectura con permisos restringidos.

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

Dirección predeterminada: http://127.0.0.1:8765/mcp

En .env se pueden prellenar H3YUN_MOBILE / H3YUN_PASSWORD. También se puede iniciar sin rellenarlos; tras conectar, llama primero a h3yun_login.

Conexión a clientes MCP

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

OPC Feed usa mcp_connection_parse → probe → propose. En Cursor basta con configurar la misma URL en los ajustes de MCP. Las credenciales se quedan en este servicio; no las escribas en el repositorio del cliente.

Variables de entorno

Limitaciones

• El /v1 web no tiene garantía oficial de estabilidad; las versiones de 氚云 pueden cambiar los campos.

• Demasiados intentos fallidos de contraseña bloquean la cuenta; este servicio cachea el token y limita la frecuencia de inicio de sesión.

• El inicio de sesión con contraseña en línea puede mostrar un código de verificación de Alibaba Cloud. Para uso desatendido, se puede usar H3YUN_TOKEN + H3YUN_ENGINE_CODE de una sesión ya iniciada en el navegador.

• El servicio MCP en sí no autentica a los llamadores. Por defecto solo escucha en la máquina local; no expongas el puerto a Internet.

• No subas .env, tokens ni EngineSecret. Los valores de retorno de las herramientas eliminan password / token.

uv run pytest

Licencia

MIT. Consulta CONTRIBUTING.md y SECURITY.md.