MCP server for unlost machine APIs via API Token
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"unlost-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# unlost-mcp MCP server (stdio) that exposes unlost **machine APIs** (`/api/v1/chats`、`/api/v1/messages` 及媒体相关只读接口) to hosts such as **Cursor**, authenticated with an API Token from Settings → 集成. Tools are read-only; summarization stays in the agent — there is no `summarize` tool. ## Requirements - Python 3.11+ - [uv](https://docs.astral.sh/uv/)（推荐用 `uvx` / `uv run`） - 可达的 unlost 后端（`UNLOST_BASE_URL`） - API Token（Settings → 集成） ## 1. Cursor MCP（推荐：本地 uv run） 未发布到 PyPI 时，用 monorepo 里的包直接跑： ```json { "mcpServers": { "unlost": { "command": "uv", "args": [ "--directory", "/ABS/PATH/unlost/mcp", "run", "unlost-mcp" ], "env": { "UNLOST_BASE_URL": "http://127.0.0.1:8000", "UNLOST_API_TOKEN": "ul_...." } } } } ``` ### 发布到 PyPI 后（可选） ```json { "mcpServers": { "unlost": { "command": "uvx", "args": ["unlost-mcp"], "env": { "UNLOST_BASE_URL": "https://unlost.onelooker.cc", "UNLOST_API_TOKEN": "ul_...." } } } } ``` 固定版本示例：`"args": ["unlost-mcp==0.1.0"]`。 ## 2. Local install / debug ```bash cd mcp uv sync export UNLOST_BASE_URL=http://127.0.0.1:8000 export UNLOST_API_TOKEN=ul_.... uv run unlost-mcp ``` stdio：等待 MCP host；缺环境变量时 stderr 提示并以 code 1 退出。 等价入口：`uv run python -m unlost_mcp`。 ## 3. Publish to PyPI（维护者） ```bash cd mcp uv build uv publish ``` 发版前 bump `pyproject.toml` 的 `version`，再 `uv build && uv publish`。 ## 4. Tools | Tool | Maps to | | --- | --- | | `list_chats(source?)` | `GET /api/v1/chats` | | `fetch_messages(chat_id?, source?, date_from?, date_to?, after_id?, limit?)` | `GET /api/v1/messages`（条目含 ``media[]``） | | `get_message(chat_id, message_id, source?)` | `GET /api/v1/messages/get_one`（单条完整媒体） | | `list_attachments(category, chat_id?, …)` | `GET /api/v1/messages/list_attachments`（`media` / `file` / `link`） | `media[]` 字段含 `kind`、`mime`、`size`、`file_name`、`width`/`height`、`status`、公开 `url`（MinIO）。HTTP …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.