Limitless MCP Server (v0.1.0)

Limitless MCP 服务（v0.1.0）

这是一个 MCP（Model Context Protocol）服务，可通过 Limitless API 将你的 Limitless Pendant 数据连接到 Claude、Windsurf 等 AI 工具。它让 AI 聊天界面和 Agent 能以结构化、可编程的方式与你的 Lifelog 交互。让我们从每一次充满上下文的交互开始，共同迈向更有条理、更智能的未来。

什么是 MCP？
Model Context Protocol 是一项用于将 AI 模型连接到外部工具和数据的开放标准——可以把它想象成 AI 领域的 USB-C 接口，甚至是 HTTP 协议：通用、可靠，且专为扩展性而设计。这是一项人人都采用的标准。它支持丰富的集成、自定义工作流，以及 AI 与你日常使用的工具之间的无缝通信。

重要说明： 截至 2025 年 3 月，Limitless API 要求数据必须通过 Limitless Pendant 录制。此服务依赖通过 Limitless Pendant 录制的真实数据——没有这些数据，它不会返回任何有意义的内容。请确保 Pendant 已连接并正在录制。

API 状态与未来计划：

• 官方 Limitless API 目前处于 测试版。因此，它偶尔可能不稳定、发生变化或暂时不可用。
• 请求大量数据（例如，列出或搜索数百条日志）有时可能会因 API 或网络限制而导致 超时错误（例如 504 Gateway Time-out）。服务为每次 API 调用设置了 120 秒超时以缓解此问题，但请求量过大时仍可能失败。
• Limitless API 正在 积极开发中。官方 API 推出新功能和改进后，此 MCP 服务也会随之更新。
• 此 MCP 服务的 0.2.0 版本 已在开发中，计划在不久的将来加入更完善的功能，并可能新增工具！

功能（v0.1.0）

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

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

前置条件

• Node.js（需要 v18 或更高版本）
• npm 或 yarn
• Limitless 账户和 API 密钥（在此获取）
• Limitless Pendant（获取数据所必需）
• 能够启动 stdio 服务并传递环境变量的 MCP 客户端应用（例如 Claude、Windsurf、Cursor、ChatWise、ChatGPT（即将推出！））。

设置

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": ["<FULL_FILE_PATH_TO_DIST_SERVER.js>"],
      "env": {
        "LIMITLESS_API_KEY": "<YOUR_LIMITLESS_API_KEY_HERE>"
      }
    }
  }
}

示例 B：添加到现有服务

如果 mcpServers 对象中已包含其他服务（例如 "notion": {...}），请在其旁添加 "limitless" 配置块，并确保 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> 等占位文本，并替换为你的实际密钥。

运行服务（通过客户端）

请勿直接运行 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 的客户端应用启动。

贡献

有想法、改进建议或反馈？欢迎提交 issue 或 PR，始终欢迎贡献！让我们继续拓展可穿戴设备上下文与智能工具的可能性。https://github.com/ipvr9/mcp-limitless-server