fast-h3yun

Войдите под своей учётной записью 氚云 и превратите приложения, формы и записи из веб-рабочего стола в инструменты FastMCP. Для запросов из Cursor, OPC Feed или других MCP-клиентов.

Это не официальный продукт 氚云 и не официальный OpenAPI. Сессия создаётся через веб-вход: телефон + пароль → 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. Логин и пароль остаются в этом сервисе, не записывайте их в репозиторий клиента.

Переменные окружения

Ограничения

• Веб-/v1 не имеет официальных гарантий стабильности; 氚云 может менять поля при выпуске версий.

• При слишком частых ошибках пароля аккаунт блокируется; сервис кэширует token и ограничивает частоту входов.

• При входе по паролю в онлайне может появляться проверочный код Aliyun. Для работы без присмотра можно использовать уже авторизованный в браузере H3YUN_TOKEN + H3YUN_ENGINE_CODE.

• Сам MCP-сервис не аутентифицирует вызывающих. По умолчанию он слушает только локальный хост — не открывайте порт в публичную сеть.

• Не коммитьте .env, token или EngineSecret. Возвращаемые значения инструментов удаляют password / token.

uv run pytest

Лицензия

MIT. Смотрите CONTRIBUTING.md и SECURITY.md.