Limitless Lifelog MCP服务器

项目简介

Limitless Lifelog MCP服务器是一个基于Model Context Protocol (MCP) 的应用后端，它允许AI客户端（如Claude、Windsurf等）通过标准化的MCP协议访问和利用您的Limitless Pendant设备记录的Lifelog数据。该服务器充当桥梁，将您的个人Lifelog数据安全地提供给支持MCP协议的AI工具，实现上下文感知的人工智能交互体验。

主要功能点

Lifelog数据访问: 提供多种方式检索和访问您的Limitless Pendant记录的Lifelog数据，包括按ID、日期、日期范围以及最近记录列表等。
Lifelog数据搜索: 支持在最近的Lifelog记录中进行关键词搜索，快速定位相关信息。
MCP协议标准: 完全遵循Model Context Protocol标准，确保与各种MCP客户端的兼容性和互操作性。
工具化接口: 通过预定义的工具 (Tools) 向MCP客户端暴露Lifelog数据访问和搜索能力，方便AI模型调用。
环境配置: 通过环境变量 'LIMITLESS_API_KEY' 安全地管理Limitless API密钥。

安装步骤

克隆仓库: 将 'mcp-limitless-server' 仓库克隆到本地。

git clone https://github.com/ipvr9/mcp-limitless-server.git
cd mcp-limitless-server

安装依赖: 使用 npm 或 yarn 安装项目依赖。

npm install

或

yarn install

构建项目: 构建 TypeScript 代码。
```
npm run build
```

服务器配置

MCP服务器需要通过MCP客户端启动，并在客户端配置中指定启动命令和必要的环境变量。以下是在MCP客户端配置文件 ('mcpServers') 中添加 'limitless' 服务器配置的示例（JSON 格式）：

添加到 'mcpServers' 配置 (示例 A: 作为第一个/唯一服务器)

{
  "mcpServers": {
    "limitless": {
      "command": "node",
      "args": ["<server.js 文件的绝对路径>"],
      "env": {
        "LIMITLESS_API_KEY": "<您的 Limitless API 密钥>"
      }
    }
  }
}

添加到 'mcpServers' 配置 (示例 B: 添加到现有服务器)

{
  "mcpServers": {
    "已有的服务器名称": {
      "command": "...",
      "args": ["..."],
      "env": {
        "EXAMPLE_VAR": "value"
      }
    },
    "limitless": {
      "command": "node",
      "args": ["<server.js 文件的绝对路径>"],
      "env": {
        "LIMITLESS_API_KEY": "<您的 Limitless API 密钥>"
      }
    }
  }
}

配置参数说明:

'"limitless"': 服务器名称，可以自定义，用于在MCP客户端中标识该服务器。
'"command": "node"': 启动服务器的命令，这里使用 Node.js 运行环境。
'"args": ["<server.js 文件的绝对路径>"]': 启动命令的参数，需要替换为 'dist/server.js' 文件在您本地文件系统中的绝对路径。例如：'"/Users/yourname/Documents/mcp-limitless-server/dist/server.js"'。
'"env": { "LIMITLESS_API_KEY": "<您的 Limitless API 密钥>" }': 设置环境变量，必须将 '<您的 Limitless API 密钥>' 替换为您在 Limitless 开发者平台获取的 API 密钥。

请务必注意:

'<server.js 文件的绝对路径>' 必须是 'dist/server.js' 文件的绝对路径。
'<您的 Limitless API 密钥>' 必须替换为您真实的 Limitless API 密钥。
MCP 配置文件不支持注释，请删除示例中的注释文字。

基本使用方法

配置 MCP 客户端: 按照上述 "服务器配置" 步骤，将 'limitless' 服务器添加到您的 MCP 客户端配置文件中。
启动 MCP 客户端: 启动您的 MCP 客户端应用程序（例如 Claude、Windsurf 等）。客户端启动后，会自动根据配置启动 'mcp-limitless-server' 服务器。
使用 MCP 工具: 在 MCP 客户端中，您可以调用以下工具来访问 Lifelog 数据：
- 'limitless_get_lifelog_by_id': 根据 Lifelog ID 获取单个 Lifelog 记录。
- 'limitless_list_lifelogs_by_date': 获取指定日期的 Lifelog 记录列表。
- 'limitless_list_lifelogs_by_range': 获取指定日期范围内的 Lifelog 记录列表。
- 'limitless_list_recent_lifelogs': 获取最近的 Lifelog 记录列表。
- 'limitless_search_lifelogs': 在最近的 Lifelog 记录中搜索关键词。
具体工具的使用方法和参数，请参考 MCP 客户端的文档或在客户端中查询服务器的能力描述。

重要提示:

本服务器依赖于 Limitless Pendant 设备记录的数据，请确保您已佩戴 Pendant 并正常记录数据。
Limitless API 目前处于 Beta 阶段，可能存在不稳定或速率限制的情况。

关键词