mcp-limitless-server

# Limitless MCP Server (v0.1.0)   这是一个 MCP (Model Context Protocol) 服务器，它通过 [Limitless API](https://limitless.ai/developers) 将你的 Limitless Pendant 数据连接到像 Claude、Windsurf 等 AI 工具。它允许 AI 聊天界面和代理以结构化、可编程的方式与你的 Lifelog 交互。让我们朝着一个更有组织、更智能的未来前进——一次丰富的交互。 > **什么是 MCP？** > [Model Context Protocol](https://modelcontextprotocol.io/introduction) 是一个将 AI 模型连接到外部工具和数据的开放标准——可以把它想象成 AI 的 USB-C 端口，甚至是 HTTP 协议——通用的、可靠的，并且为可扩展性而设计。每个人都采用的标准。它实现了丰富的集成、自定义工作流程以及 AI 和你每天使用的工具之间的无缝通信。 **重要提示：** 截至 2025 年 3 月，Limitless API **需要通过 Limitless Pendant 记录的数据**。此服务器依赖于从你的 Limitless Pendant 记录的真实数据——没有它，它不会返回任何有意义的内容。确保你的 Pendant 已连接并正在录制。 **API 状态 & 未来计划：** * 官方 Limitless API 目前处于 **beta** 阶段。因此，它可能偶尔不可靠、可能会发生变化或遇到临时中断。 * 请求大量数据（例如，列出或搜索数百个日志）有时可能会导致 **超时错误（如 504 Gateway Time-out）**，这是由于 API 或网络限制。服务器包括每个 API 调用 120 秒的超时时间来缓解这种情况，但非常大的请求可能仍然会失败。 * Limitless API 正在 **积极开发中**。此 MCP 服务器将随着官方 API 中新功能和改进的可用性而更新。 * 此 MCP 服务器的 **0.2.0 版本** 已经在开发中，计划在不久的将来添加更强大的功能和潜在的新工具！ ## Features (v0.1.0) * **List/Get Lifelogs:** 通过 ID、日期、日期范围检索 Pendant 录音，或列出最近的条目。包括对排序方向 (`asc`/`desc`) 的控制。 * **Search Recent Logs:** 在可配置数量的最近 Pendant 录音的内容中执行简单的文本搜索（注意：只有最近的日志可以搜索；不支持完整历史搜索）。 > 通过此服务器，你可以执行诸如从你的 Lifelog 中提取操作项并将它们直接发送到 Notion 之类的操作——通过 Claude、ChatWise、Windsurf 或任何其他支持 MCP 的 AI 助手/应用程序。 ## Prerequisites * Node.js (v18 or later required) * npm or yarn * 一个 Limitless 帐户和 API 密钥 ([Get one here](https://limitless.ai/developers)) * **A Limitless Pendant (Required for data)** * 一个能够生成 stdio 服务器并传递环境变量的 MCP 客户端应用程序（例如，Claude、Windsurf、Cursor、ChatWise、ChatGPT（即将推出！））。 ## Setup 1. **Clone or download this project.** 2. **Navigate to the directory:** ```bash cd mcp-limitless-server ``` 3. **Install dependencies:** ```bash npm install ``` 4. **Build the code:** ```bash npm run build ``` ## Configuration (Client-Side) 此服务器希望在 MCP 客户端启动它时，将 `LIMITLESS_API_KEY` 作为**环境变量**提供。 你需要向 MCP 客户端的设置文件中添加一个服务器配置块。以下是两个示例，具体取决于你是将此服务器添加为第一个服务器还是与现有服务器一起添加。 **示例 A：添加为第一个/唯一服务器** 如果你的客户端配置文件当前有一个空的 `mcpServers` 对象 (`"mcpServers": {}`)，请将其替换为： ```json { "mcpServers": { "limitless": { "command": "node", "args": ["<FULL_FILE_PATH_TO_DIST_SERVER.js>"], "env": { "LIMITLESS_API_KEY": "<YOUR_LIMITLESS_API_KEY_HERE>" } } } } ``` **示例 B：添加到现有服务器** 如果你的 `mcpServers` 对象已经包含其他服务器（如 `"notion": {...}`），请将 `"limitless"` 块与它们一起添加，确保正确的 JSON 语法（条目之间用逗号分隔）： ```json { "mcpServers": { "some_other_server": { "command": "...", "args": ["..."], "env": { "EXAMPLE_VAR": "value" } }, "limitless": { "command": "node", "args": ["<FULL_FILE_PATH_TO_DIST_SERVER.js>"], "env": { "LIMITLESS_API_KEY": "<YOUR_LIMITLESS_API_KEY_HERE>" } } } } ``` **重要提示：** * 将 `<FULL_FILE_PATH_TO_DIST_SERVER.js>` 替换为已构建服务器脚本的正确**绝对路径**（例如，`/Users/yourname/Documents/MCP/mcp-limitless-server/dist/server.js`）。相对路径可能无法可靠地工作，具体取决于客户端。 * 将 `<YOUR_LIMITLESS_API_KEY_HERE>` 替换为你的实际 Limitless API 密钥。 * MCP 配置文件**不能包含注释**。删除任何占位符文本（如 `<YOUR_LIMITLESS_API_KEY_HERE>`）并将其替换为你的实际密钥。 ## Running the Server (via Client) **Do not run `npm start` directly.** 1. 确保服务器已成功构建 (`npm run build`)。 2. 如上所示配置你的 MCP 客户端。 3. 启动你的 MCP 客户端应用程序。它会在需要时自动启动 `mcp-limitless-server` 进程。 ## Exposed MCP Tools (v0.1.0) （有关完整详细信息，请参阅 [`src/server.ts`](./src/server.ts) 或通过你的客户端询问服务器。） 1. **`limitless_get_lifelog_by_id`**: 通过其特定 ID 检索单个 Pendant 录音。 2. **`limitless_list_lifelogs_by_date`**: 列出特定日期的 Pendant 录音。 3. **`limitless_list_lifelogs_by_range`**: 列出日期/时间范围内的 Pendant 录音。 4. **`limitless_list_recent_lifelogs`**: 列出最近的 Pendant 录音。 5. **`limitless_search_lifelogs`**: 搜索*最近* Pendant 录音的标题/内容（范围有限！）。 ## Notes & Limitations 🚫 **Pendant Required** 此服务器依赖于 Limitless Pendant 生成的数据。 🧪 **API Beta Status** Limitless API 处于 beta 阶段，可能会遇到偶尔的不稳定或速率限制。大型请求可能会导致超时（例如，504 错误）。 🔍 **Search Scope** `limitless_search_lifelogs` 仅扫描有限数量的最近日志（默认 20 个，最多 100 个）。它*不*搜索你的完整历史记录——首先使用列表工具进行更广泛的分析。 ⚠️ **Error Handling & Timeout** API 错误会转换为 MCP 错误结果。每个 API 调用都有 120 秒的超时时间。 🔌 **Transport** 此服务器使用 `stdio`，旨在由 MCP 兼容的客户端应用程序启动。 ## Contributing 有想法、改进或反馈？请随时提出问题或 PR——欢迎大家做出贡献！让我们不断突破可穿戴上下文和智能工具的界限。[https://github.com/ipvr9/mcp-limitless-server](https://github.com/ipvr9/mcp-limitless-server)