fast-h3yun

자신의 氚云 계정으로 로그인하여 웹 작업대의 앱, 폼, 기록을 FastMCP 도구로 만듭니다. Cursor, OPC Feed 또는 다른 MCP 클라이언트에서 조회하는 데 사용할 수 있습니다.

이것은 氚云 공식 제품도 아니고 공식 OpenAPI도 아닙니다. 세션은 웹 로그인에서 비롯됩니다: 手机号 + 密码 → JWT + EngineCode. 무엇을 볼 수 있는지는 해당 로그인 사용자의 권한에 따라 달라집니다.

할 수 있는 일

1차 버전은 읽기 전용입니다. 생성, 수정, 삭제 또는 승인을 하지 않습니다.

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은 공식 안정성 보장이 없으며, 氚云 릴리스에서 필드가 변경될 수 있습니다.

• 비밀번호 오류 횟수가 너무 많으면 계정이 잠깁니다. 본 서비스는 토큰을 캐시하고 로그인 빈도를 제한합니다.

• 온라인 비밀번호 로그인 시 阿里云 인증 코드가 나타날 수 있습니다. 무인 환경에서는 브라우저에 이미 로그인된 H3YUN_TOKEN + H3YUN_ENGINE_CODE를 사용하면 됩니다.

• MCP 서비스 자체는 호출자를 인증하지 않습니다. 기본적으로 로컬에서만 수신 대기하므로 포트를 공개 네트워크에 노출하지 마세요.

• .env, 토큰 또는 EngineSecret을 커밋하지 마세요. 도구 반환 값에서 password / token이 제거됩니다.

uv run pytest

라이선스

MIT입니다. CONTRIBUTING.md와 SECURITY.md를 확인해 주세요.