Limitless MCP Server

无限 MCP 服务器 (v0.1.0)

这是一个 MCP（模型上下文协议）服务器，它通过Limitless API将您的 Limitless 吊坠数据连接到 Claude、Windsurf 等 AI 工具。它允许 AI 聊天界面和代理以结构化、可编程的方式与您的 Lifelog 进行交互。让我们一起构建一个更有条理、更智能的未来——一次一个丰富的情境互动。

什么是 MCP？
模型上下文协议 (MCP)是一个用于连接 AI 模型和外部工具和数据的开放标准——可以将其视为 AI 的 USB-C 端口，甚至是 HTTP 协议——它通用、可靠，并且专为可扩展性而设计。它是一个人人都采用的标准。它支持丰富的集成、自定义工作流，以及 AI 与您日常使用的工具之间的无缝通信。

重要提示：自 2025 年 3 月起，Limitless API需要通过 Limitless 吊坠记录数据。此服务器依赖于您的 Limitless 吊坠记录的真实数据——如果没有这些数据，它将无法返回任何有意义的信息。请确保您的吊坠已连接并正在记录。

API 状态和未来计划：

• 官方 Limitless API 目前处于测试阶段。因此，它可能偶尔不可靠、可能发生变更或出现暂时中断。
• 由于 API 或网络限制，请求大量数据（例如，列出或搜索数百条日志）有时可能会导致超时错误（例如 504 网关超时） 。服务器为每个 API 调用设置了 120 秒的超时时间，以缓解此问题，但非常大的请求仍然可能失败。
• Limitless API 正在积极开发中。一旦官方 API 中推出新功能和改进，此 MCP 服务器将进行更新。
• 该 MCP 服务器的0.2.0 版本已在开发中，计划在不久的将来添加更多强大的功能和潜在的新工具！

功能（v0.1.0）

• **列出/获取生活日志：**按 ID、日期、日期范围检索 Pendant 记录，或列出最近的记录。支持排序方向控制（ asc / desc ）。
• **搜索最近的日志：**在可配置数量的最近 Pendant 记录内容中执行简单的文本搜索（注意：只能搜索最近的日志；不支持完整历史记录搜索）。

使用此服务器，您可以从 Lifelog 中提取行动项目并将其直接发送到 Notion——通过 Claude、ChatWise、Windsurf 或任何其他支持 MCP 的 AI 助手/应用程序。

先决条件

• Node.js（需要 v18 或更高版本）
• npm 或 yarn
• 无限账户和 API 密钥（在此获取）
• 无限吊坠（数据所需）
• MCP 客户端应用程序（例如，Claude、Windsurf、Cursor、ChatWise、ChatGPT（即将推出！））能够生成 stdio 服务器并传递环境变量。

设置

1. 克隆或下载此项目。
2. 导航到目录：
   cd mcp-limitless-server
3. 安装依赖项：
   npm install
4. 构建代码：
   npm run build

配置（客户端）

此服务器期望当您的 MCP 客户端启动它时，将LIMITLESS_API_KEY作为环境变量提供。

您需要在 MCP 客户端的设置文件中添加一个服务器配置块。以下是两个示例，具体取决于您是将其添加为第一个服务器，还是将其与现有服务器一起添加。

示例 A：添加为第一个/唯一服务器

如果您的客户端的配置文件当前有一个空的mcpServers对象（ "mcpServers": {} ），请将其替换为：

示例 B：添加到现有服务器

如果您的mcpServers对象已经包含其他服务器（如"notion": {...} ），请在它们旁边添加"limitless"块，确保正确的 JSON 语法（条目之间的逗号）：

重要的：

• 将<FULL_FILE_PATH_TO_DIST_SERVER.js>替换为构建的服务器脚本的正确绝对路径(例如， /Users/yourname/Documents/MCP/mcp-limitless-server/dist/server.js )。相对路径可能无法可靠地工作，具体取决于客户端。
• 用您的实际 Limitless API 密钥替换<YOUR_LIMITLESS_API_KEY_HERE> 。
• MCP 配置文件不能包含注释。请删除所有占位符文本（例如<YOUR_LIMITLESS_API_KEY_HERE> ），并将其替换为您的实际密钥。

运行服务器（通过客户端）

不要直接运行npm start 。

1. 确保服务器已成功构建（ npm run build ）。
2. 按照上面所示配置您的 MCP 客户端。
3. 启动您的 MCP 客户端应用程序。它会在需要时自动启动mcp-limitless-server进程。

公开的 MCP 工具 (v0.1.0)

（请参阅src/server.ts或通过客户端向服务器询问完整详细信息。）

1. limitless_get_lifelog_by_id ：通过特定 ID 检索单个吊坠记录。
2. limitless_list_lifelogs_by_date ：列出特定日期的吊坠记录。
3. limitless_list_lifelogs_by_range ：列出日期/时间范围内的吊坠记录。
4. limitless_list_recent_lifelogs ：列出最近的吊坠记录。
5. limitless_search_lifelogs ：搜索最近的Pendant 录音的标题/内容（范围有限！）。

注意事项和限制

🚫需要吊坠
该服务器依赖于无限吊坠生成的数据。

🧪 API Beta 状态
Limitless API 尚处于测试阶段，可能会偶尔出现不稳定或速率受限的情况。大量请求可能会导致超时（例如 504 错误）。

🔍搜索范围
limitless_search_lifelogs仅扫描有限数量的近期日志（默认 20 条，最多 100 条）。它不会搜索您的全部历史记录——请优先使用列表工具进行更广泛的分析。

⚠️错误处理和超时
API 错误会被转换为 MCP 错误结果。每次 API 调用的超时时间为 120 秒。

🔌交通
该服务器使用stdio并由 MCP 兼容的客户端应用程序启动。

贡献

有任何想法、改进或反馈？欢迎随时提交问题或 PR——我们随时欢迎大家贡献代码！让我们继续探索可穿戴环境和智能工具的无限可能。https ://github.com/ipvr9/mcp-limitless-server