loading…
Search for a command to run...
loading…
MCP server for HotLogin Local API that enables AI agents to manage browser environments, groups, and proxies, and perform browser automation tasks like page int
MCP server for HotLogin Local API that enables AI agents to manage browser environments, groups, and proxies, and perform browser automation tasks like page interaction and cookie management through a standardized interface.
HotLogin Local API 的 MCP（Model Context Protocol）服务封装，用于让 AI Agent / MCP 客户端通过标准 MCP tools 调用本地 HotLogin 服务，实现：
提示：本项目只负责“调用本地 HotLogin 服务”，不包含 HotLogin 客户端本身。
health_checkenv_*：env_query / env_profile / env_create / env_revise / env_launch / env_terminate / env_terminate_all / env_opened / env_window_layout …group_*：group_query / group_create / group_revise / group_removeproxy_*：proxy_query / proxy_create / proxy_revise / proxy_removesession_attach / tab_spawnpage_visit / page_capture / page_text / page_html / page_meta / page_reload / page_back / page_forward / page_wait_loadelement_tap / element_write / element_pick / element_hover / element_scroll / element_move / element_wait / element_exists / element_text / element_attr / element_count / element_check / element_uncheck / element_frame_tapkey_press / script_eval / mouse_click_pos / dialog_handlecookie_read / cookie_write / cookie_clear / storage_read / storage_write工具的完整注册列表见 src/mcp/tools.ts，参数校验见 src/mcp/schemas.ts。
在本仓库目录下：
npm install
npm run build
构建产物默认在 build/，可执行入口为 build/server.core.js（见 package.json 的 main/bin）。
将 MCP Server 配置加入你的客户端配置中（示例为 npx 运行已发布包；若你本地开发，可改成 node <path>/build/server.core.js）。
{
"mcpServers": {
"hotlogin-local-api": {
"command": "npx",
"args": ["-y", "hotlogin-local-api-mcp"]
}
}
}
{
"mcpServers": {
"hotlogin-local-api": {
"command": "cmd",
"args": ["/c", "npx", "-y", "hotlogin-local-api-mcp"]
}
}
}
如果你还没发布到 npm：把
command/args改为node直接指向本地构建产物即可。
该 MCP server 会请求 HotLogin Local API。常用配置如下（具体字段见 src/api/config.ts）：
LOCAL_SERVICE_ENDPOINT：本地服务地址（例如 http://127.0.0.1:50325 之类）LOCAL_SERVICE_PORT：本地服务端口（当 endpoint 未设置时使用）LOCAL_SERVICE_TOKEN：鉴权 token（如你的本地服务启用了鉴权）在 MCP 客户端的 server 配置里可以通过 env 传入，例如：
{
"mcpServers": {
"hotlogin-local-api": {
"command": "npx",
"args": ["-y", "hotlogin-local-api-mcp"],
"env": {
"LOCAL_SERVICE_PORT": "50325",
"LOCAL_SERVICE_TOKEN": "your-token"
}
}
}
}
env_create：创建环境（可带代理/指纹/账号信息）env_launch：启动环境，拿到返回中的 wsEndpoint（或 puppeteer 字段里的 ws 地址）session_attach：用 wsEndpoint 连接到浏览器会话page_visit / element_*：执行页面操作env_terminate：任务结束后关闭环境（或 env_terminate_all 批量关闭）LOCAL_SERVICE_ENDPOINT/PORT 指向正确LOCAL_SERVICE_TOKEN 正确wsEndpoint 可能已经过期：重新 env_launch 获取新的 endpointLOCAL_SERVICE_TOKEN，不要提交到仓库或分享给不可信方如需开源发布，请在此处补充你的项目许可证文件（例如 LICENSE）。
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"hotlogin-mcp": {
"command": "npx",
"args": []
}
}
}