Limitless MCP 服务器 (v0.1.0)

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

什么是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、日期、日期范围或最近条目列表检索挂件录音。包括对排序方向 (asc/desc) 的控制。
• 搜索最近的日志： 在配置数量的最近挂件录音内容中执行简单的文本搜索（注意：仅最近的日志可搜索；不支持完整历史搜索）。

通过这个服务器，您可以做诸如从生活日志中提取行动项并通过Claude、ChatWise、Windsurf或任何其他支持MCP的AI助手/应用程序直接发送到Notion这样的事情。

先决条件

• Node.js（需要 v18 或更高版本）
• npm 或 yarn
• 一个 Limitless 账户和 API 密钥（在这里获取）
• Limitless 吊坠（数据必需）
• 一个 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": ["<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 检索单个吊坠记录。
2. limitless_list_lifelogs_by_date：列出特定日期的吊坠记录。
3. limitless_list_lifelogs_by_range：列出在某个日期/时间范围内的吊坠记录。
4. limitless_list_recent_lifelogs：列出最近的吊坠记录。
5. limitless_search_lifelogs：搜索最近吊坠记录的标题/内容（有限范围！）。

注意事项和限制

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

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

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

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

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

贡献

有想法、改进建议或反馈？随时欢迎提出问题或提交 PR —— 我们非常欢迎任何贡献！让我们继续推动可穿戴上下文和智能工具的可能性边界。https://github.com/ipvr9/mcp-limitless-server