Limitless MCP 服务器 (v0.1.0)

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

什么是 MCP？ 模型上下文协议 是一个开放标准，用于将 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 版本 已经在开发中，计划在不久的将来添加更强大的功能和潜在的新工具！

功能 (v0.1.0)

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

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

前提条件

• Node.js (需要 v18 或更高版本)
• npm 或 yarn
• 一个 Limitless 帐户和 API 密钥 (在此处获取)
• 一个 Limitless Pendant (需要数据)
• 一个 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": {})，请将其替换为：

{
  "mcpServers": {
    "limitless": {
      "command": "node",
      "args": ["<DIST_SERVER.js 的完整文件路径>"],
      "env": {
        "LIMITLESS_API_KEY": "<您的_LIMITLESS_API_KEY_在此处>"
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "some_other_server": {
      "command": "...",
      "args": ["..."],
      "env": {
        "EXAMPLE_VAR": "value"
      }
    },
    "limitless": {
      "command": "node",
      "args": ["<DIST_SERVER.js 的完整文件路径>"],
      "env": {
        "LIMITLESS_API_KEY": "<您的_LIMITLESS_API_KEY_在此处>"
      }
    }
  }
}

重要提示：

• 将 <DIST_SERVER.js 的完整文件路径> 替换为已构建服务器脚本的正确绝对路径（例如，/Users/yourname/Documents/MCP/mcp-limitless-server/dist/server.js）。 根据客户端的不同，相对路径可能无法可靠地工作。
• 将 <您的_LIMITLESS_API_KEY_在此处> 替换为您实际的 Limitless API 密钥。
• MCP 配置文件不能包含注释。 删除任何占位符文本，例如 <您的_LIMITLESS_API_KEY_在此处>，并将其替换为您实际的密钥。

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

不要直接运行 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 检索单个 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 录音的标题/内容（范围有限！）。

注意事项 & 限制

🚫 需要 Pendant 此服务器依赖于 Limitless Pendant 生成的数据。

🧪 API Beta 状态 Limitless API 处于 beta 阶段，可能会遇到偶尔的不稳定或速率限制。 大量请求可能会导致超时（例如，504 错误）。

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

⚠️ 错误处理 & 超时 API 错误会转换为 MCP 错误结果。 每个 API 调用都有 120 秒的超时时间。

🔌 传输 此服务器使用 stdio，旨在由 MCP 兼容的客户端应用程序启动。

贡献

有想法、改进或反馈？ 随时提出问题或 PR——欢迎大家贡献！ 让我们不断突破可穿戴上下文和智能工具的界限。https://github.com/ipvr9/mcp-limitless-server