fast-h3yun

Melde dich mit deinem eigenen 氚云-Konto an und mache Apps, Formulare und Datensätze aus der Web-Arbeitsumgebung zu FastMCP-Tools. Zum Abfragen für Cursor, OPC Feed oder andere MCP-Clients.

Dies ist kein offizielles Produkt von 氚云 und auch keine offizielle OpenAPI. Die Sitzung stammt aus der Web-Anmeldung: Handynummer + Passwort → JWT + EngineCode. Was du sehen kannst, hängt von den Berechtigungen des angemeldeten Benutzers ab.

Funktionen

Erste Version nur lesend: Es wird nichts erstellt, geändert, gelöscht oder genehmigt.

Related MCP server: Feishu Bitable MCP Server

Start

Erforderlich sind Python 3.12+ und uv. Es wird empfohlen, ein 氚云-Konto mit eingeschränkten, nur lesenden Berechtigungen zu verwenden.

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

Standardadresse: http://127.0.0.1:8765/mcp

In .env können H3YUN_MOBILE / H3YUN_PASSWORD vorab eingetragen werden. Auch ohne diese Angaben lässt sich der Dienst starten; nach dem Verbinden zuerst h3yun_login aufrufen.

An MCP-Clients anbinden

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

OPC Feed läuft über mcp_connection_parse → probe → propose. Bei Cursor genügt es, dieselbe URL in den MCP-Einstellungen zu konfigurieren. Kontodaten und Passwort bleiben in diesem Dienst und sollten nicht in das Client-Repository geschrieben werden.

Umgebungsvariablen

Einschränkungen

• Das Web-/v1 hat keine offizielle Stabilitätszusage; 氚云 kann bei Releases Felder ändern.

• Zu viele Fehlversuche beim Passwort führen zu einer Sperre; dieser Dienst cached Tokens und begrenzt die Anmeldefrequenz.

• Bei der Online-Passwortanmeldung kann ein Alibaba-Cloud-Verifizierungscode erscheinen. Für unbeaufsichtigten Betrieb kann stattdessen ein bereits im Browser angemeldetes H3YUN_TOKEN + H3YUN_ENGINE_CODE verwendet werden.

• Der MCP-Dienst selbst authentifiziert Aufrufer nicht. Standardmäßig wird nur auf dem lokalen Rechner gelauscht; der Port sollte nicht öffentlich freigegeben werden.

• .env, Tokens oder EngineSecret nicht einchecken. Die Tool-Rückgabewerte entfernen password / token.

uv run pytest

Lizenz

MIT. Siehe auch CONTRIBUTING.md und SECURITY.md.