mcp-limitless-server

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

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

🚀 快速开始

这是一个将您的无限制项圈数据连接到 AI 工具（如Claude、Windsurf 等）的 MCP（模型上下文协议）服务器，通过无限制 API。它使 AI 聊天界面和代理能够以结构化且可编程的方式与您的生活日志交互。

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

✨ 主要特性

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

📦 安装指南

1. 克隆仓库：

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

2. 安装依赖：

   npm install
   

3. 构建项目：

   npm run build
   

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

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

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

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

📚 详细文档

提供的 MCP 工具（v0.1.0）

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

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：搜索近期项圈记录的标题和内容（范围有限）。

🔧 技术细节

注意事项与限制

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

📄 许可证

本项目采用 MIT 许可证，详情请见 。

贡献

有关想法、改进或反馈？欢迎打开问题或提交 PR——贡献总是受欢迎的！让我们一起推动可穿戴上下文与智能工具可能实现的边界。https://github.com/ipvr9/mcp-limitless-server