MCP Limitless Server

🚀 无限制 MCP 服务器（v0.1.0）

这是一个借助 无限制 API，将您的无限制项圈数据连接到 Claude、Windsurf 等 AI 工具的 MCP（模型上下文协议）服务器。它能让 AI 聊天界面和代理以结构化且可编程的方式与您的生活日志进行交互，助力我们迈向更有序、更智能的未来——开启一场富含上下文的交互之旅！

⚠️ 重要提示

模型上下文协议 是一个连接 AI 模型到外部工具和数据的开放标准，就像 Web 的 URL 一样。它使 AI 能够直接操作文件、执行任务并增强功能。

🚀 快速开始

这是一个将无限制项圈数据连接到 AI 工具的 MCP 服务器，通过特定 API 实现 AI 与生活日志的交互。

✨ 主要特性

• 与项圈集成：可直接读取和处理无限制项圈收集的数据。
• MCP 支持：通过 MCP 协议为 AI 工具提供数据接口。
• 日期范围查询：支持按特定日期或时间段检索数据。
• 搜索功能：能在最近的日志中搜索内容，便于快速定位信息。

📦 安装指南

克隆仓库

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

安装依赖

npm install

构建项目

npm run build

启动服务器（通过 MCP 兼容客户端）

• 配置 MCP 客户端，添加以下内容到配置文件：

{
  "limitless": {
    "command": "node",
    "args": ["./dist/server.js"],
    "env": {
      "LIMITLESS_API_KEY": "your_api_key_here"
    }
  }
}

• 启动您的 MCP 客户端，服务器将在需要时自动启动。

📚 详细文档

提供的 MCP 工具（v0.1.0）

以下是通过该服务器暴露的核心工具：

• limitless_get_lifelog_by_id：通过特定 ID 获取单个项圈记录。
• limitless_list_lifelogs_by_date：按指定日期列出项圈记录。
• limitless_list_lifelogs_by_range：在指定的时间范围内列出项圈记录。
• limitless_list_recent_lifelogs：列出最近的项圈记录。
• limitless_search_lifelogs：搜索近期项圈记录的标题和内容（范围有限）。

🔧 技术细节

注意事项与限制

• 项圈依赖性：此服务器依赖于无限制项圈生成的数据。
• API 的 Beta 状态：无限制 API 目前处于测试阶段，可能会出现偶尔的不稳定或速率限制。大型请求可能导致超时（例如 504 错误）。
• 搜索范围限制：limitless_search_lifelogs 只扫描最近的日志（默认 20 条，最多 100 条）。它无法搜索完整的历史记录——请先使用列表工具进行更广泛的分析。
• 错误处理与超时：API 错误将转换为 MCP 错误结果。每个 API 调用具有 120 秒的超时设置。

📄 许可证

本项目采用 MIT 许可证。

贡献

如果您有任何想法、改进建议或反馈，欢迎打开问题或提交 PR。让我们一起推动可穿戴上下文与智能工具可能实现的边界。https://github.com/ipvr9/mcp-limitless-server