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