fast-h3yun

自分の 氚雲 アカウントでログインして、Web ワークベンチのアプリ・フォーム・レコードを FastMCP ツールにします。Cursor、OPC Feed、その他の MCP クライアントから照会するために使います。

これは氚雲の公式製品でも、公式 OpenAPI でもありません。セッションは Web ログイン（携帯番号 + パスワード → JWT + EngineCode）に由来します。見える範囲は、そのログインユーザーの権限に依存します。

できること

初版は読み取り専用：作成・変更・削除・承認は行いません。

Related MCP server: Feishu Bitable MCP Server

起動

Python 3.12+ と uv が必要です。権限を絞った読み取り専用の氚雲アカウントを推奨します。

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

デフォルトアドレス：http://127.0.0.1:8765/mcp

.env に H3YUN_MOBILE / H3YUN_PASSWORD を事前に記入できます。未記入でも起動でき、接続後にまず h3yun_login を呼び出します。

MCP クライアントに接続

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

OPC Feed は mcp_connection_parse → probe → propose の順で進めます。Cursor は同じ URL を MCP 設定に追加するだけです。アカウントとパスワードは本サービス内に留め、クライアントのリポジトリには書き込まないでください。

環境変数

制限

• Web の /v1 には公式の安定性保証がなく、氚雲のリリースでフィールドが変わる可能性があります。

• パスワードの誤入力が多すぎるとロックされます。本サービスはトークンをキャッシュし、ログイン頻度を制限します。

• オンラインのパスワードログインでは、阿里雲の認証コードが表示される場合があります。無人運用では、ブラウザでログイン済みの H3YUN_TOKEN + H3YUN_ENGINE_CODE を使用できます。

• MCP サービス自体は呼び出し元を認証しません。デフォルトでは本機のみをリッスンするため、ポートを公開ネットワークに公開しないでください。

• .env、トークン、EngineSecret をコミットしないでください。ツールの戻り値からは password / token が除去されます。

uv run pytest

ライセンス

MIT。 CONTRIBUTING.md と SECURITY.md もご覧ください。