{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_wv3reqrfkv5k","handle":"unlost-mcp","url":"https://wellknown.network/agents/unlost-mcp","links":{"self":"https://wellknown.network/agents/unlost-mcp/record.json","html":"https://wellknown.network/agents/unlost-mcp","markdown":"https://wellknown.network/agents/unlost-mcp/record.md","api":"https://wellknown.network/api/v1/agents/unlost-mcp","status":"https://wellknown.network/api/v1/agents/unlost-mcp/status","claim":"https://wellknown.network/agents/unlost-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/unlost-mcp/claim.json","badge":"https://wellknown.network/agents/unlost-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/unlost-mcp/history","tools":"https://wellknown.network/api/v1/agents/unlost-mcp/tools"},"ard":{"identifier":"urn:air::server:unlost-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"unlost-mcp","summary":"MCP server for unlost machine APIs via API Token","description":"# unlost-mcp\n\nMCP 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 → 集成.\n\nTools are read-only; summarization stays in the agent — there is no `summarize` tool.\n\n## Requirements\n\n- Python 3.11+\n- [uv](https://docs.astral.sh/uv/)（推荐用 `uvx` / `uv run`）\n- 可达的 unlost 后端（`UNLOST_BASE_URL`）\n- API Token（Settings → 集成）\n\n## 1. Cursor MCP（推荐：本地 uv run）\n\n未发布到 PyPI 时，用 monorepo 里的包直接跑：\n\n```json\n{\n  \"mcpServers\": {\n    \"unlost\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"/ABS/PATH/unlost/mcp\",\n        \"run\",\n        \"unlost-mcp\"\n      ],\n      \"env\": {\n        \"UNLOST_BASE_URL\": \"http://127.0.0.1:8000\",\n        \"UNLOST_API_TOKEN\": \"ul_....\"\n      }\n    }\n  }\n}\n```\n\n### 发布到 PyPI 后（可选）\n\n```json\n{\n  \"mcpServers\": {\n    \"unlost\": {\n      \"command\": \"uvx\",\n      \"args\": [\"unlost-mcp\"],\n      \"env\": {\n        \"UNLOST_BASE_URL\": \"https://unlost.onelooker.cc\",\n        \"UNLOST_API_TOKEN\": \"ul_....\"\n      }\n    }\n  }\n}\n```\n\n固定版本示例：`\"args\": [\"unlost-mcp==0.1.0\"]`。\n\n## 2. Local install / debug\n\n```bash\ncd mcp\nuv sync\nexport UNLOST_BASE_URL=http://127.0.0.1:8000\nexport UNLOST_API_TOKEN=ul_....\nuv run unlost-mcp\n```\n\nstdio：等待 MCP host；缺环境变量时 stderr 提示并以 code 1 退出。\n\n等价入口：`uv run python -m unlost_mcp`。\n\n## 3. Publish to PyPI（维护者）\n\n```bash\ncd mcp\nuv build\nuv publish\n```\n\n发版前 bump `pyproject.toml` 的 `version`，再 `uv build && uv publish`。\n\n## 4. Tools\n\n| Tool | Maps to |\n| --- | --- |\n| `list_chats(source?)` | `GET /api/v1/chats` |\n| `fetch_messages(chat_id?, source?, date_from?, date_to?, after_id?, limit?)` | `GET /api/v1/messages`（条目含 ``media[]``） |\n| `get_message(chat_id, message_id, source?)` | `GET /api/v1/messages/get_one`（单条完整媒体） |\n| `list_attachments(category, chat_id?, …)` | `GET /api/v1/messages/list_attachments`（`media` / `file` / `link`） |\n\n`media[]` 字段含 `kind`、`mime`、`size`、`file_name`、`width`/`height`、`status`、公开 `url`（MinIO）。HTTP …","publisher":{"name":"cyetstar","url":null},"homepage":"https://github.com/cyetstar/unlost/tree/main/mcp","repository":"https://github.com/cyetstar/unlost/tree/main/mcp","version":"0.1.1","license":null,"protocols":["mcp"],"tags":["discord","mcp","telegram","unlost"],"pricing":null,"endpoints":[{"url":"pypi:unlost-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"communication.chat","name":"Team Chat","confidence":1,"provenance":"declared"},{"slug":"communication.sms-voice","name":"SMS & Voice","confidence":1,"provenance":"declared"},{"slug":"content.writing","name":"Writing & Editing","confidence":0.882,"provenance":"derived"}],"categories":["communication","content"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"unlost-mcp","registry":"pypi","observedAt":"2026-11-04T03:28:47.672Z","publishedAt":"2026-11-01T14:24:23.530401Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"unlost-mcp","url":"https://pypi.org/project/unlost-mcp/","firstSeenAt":"2026-11-04T03:26:38.201Z","fetchedAt":"2026-11-04T03:26:38.201Z","normalizedAt":"2026-11-04T03:26:38.201Z"}]},"firstSeenAt":"2026-11-04T03:26:38.201Z","updatedAt":"2026-11-04T03:28:47.672Z"}