Limitless MCP Remote

🔗 无限MCP远程服务器

一个远程模型上下文协议（MCP）服务器，为AI助手提供对无限生命日志数据的安全、时区感知访问。

  

✅ 状态：功能齐全的时区感知MCP服务器已准备好投入生产使用（更新日期：2025年7月2日）

✨ 特性

• 🌍 时区感知 -使用IANA时区标识符提供适当的时区支持
• 🔐 安全的API密钥身份验证 -您的数据使用您自己的API密钥保持隐私
• 🌐 远程MCP协议 -适用于Claude Desktop、Cursor和任何MCP客户端
• ⚡ Cloudflare员工 -全球边缘部署，实现低延迟
• 🔍 丰富的搜索和筛选 -按日期、内容、星级状态查找生活日志
• 📊 完成CRUD操作 -读取、搜索和删除生活日志条目
• 🎯 多用户支持 -每个用户都使用自己的API密钥进行连接

🚀 快速开始

生产服务器URL:

https://limitless-mcp-remote.genaijake.workers.dev

支持的交通工具：

• SSE （服务器发送的事件）： /sse?api_key=YOUR_API_KEY
• 自定义路径: /{YOUR_API_KEY}/sse （Firecrawl式布线）

🛠️ 可用工具

时区支持

服务器现在使用Limitless API的本地时区处理正确支持时区感知查询：

• 时区参数：使用IANA时区标识符（例如，“美洲/Los_Angeles”、“欧洲/伦敦”、“亚洲/东京”）
• 日期格式：日期格式为YYYY-MM-DD
• 默认：如果未指定时区，则默认为UTC

📋 例子

获取今天的生活日志（时区感知）

{
  "tool": "get_lifelogs",
  "parameters": {
    "date": "2025-07-02",
    "timezone": "America/Los_Angeles"
  }
}

获取昨天的生活日志

{
  "tool": "get_lifelogs",
  "parameters": {
    "date": "2025-07-01",
    "timezone": "America/New_York"
  }
}

搜索特定内容

{
  "tool": "search_lifelogs",
  "parameters": {
    "query": "meeting with team",
    "limit": 10
  }
}

按ID获取特定生活日志

{
  "tool": "get_lifelog_by_id",
  "parameters": {
    "id": "lifelog-entry-id-here"
  }
}

🔧 客户端配置

📱 克劳德桌面（推荐方法）

🎉 新增：本地远程MCP集成（BETA）

Claude Desktop现在支持直接远程MCP连接！不再需要本地代理。

1. 打开克劳德桌面
2. 首选 设置 → 集成
3. 点击 “添加集成”
4. 填写：

- 集成名称: Limitless Remote - 集成URL: https://limitless-mcp-remote.genaijake.workers.dev/sse?api_key=YOUR_LIMITLESS_API_KEY

1. 点击 “添加”

就是这样！Claude将直接连接到远程服务器。

📱 克劳德桌面（传统方法）

地点：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

配置：

{
  "mcpServers": {
    "limitless-remote": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://limitless-mcp-remote.genaijake.workers.dev/sse?api_key=YOUR_LIMITLESS_API_KEY"
      ]
    }
  }
}

🖱️ 光标

地点： ~/.cursor/mcp.json （如果不存在则创建）

配置：

{
  "mcpServers": {
    "limitless-remote": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://limitless-mcp-remote.genaijake.workers.dev/sse?api_key=YOUR_LIMITLESS_API_KEY"
      ]
    }
  }
}

🛠️ 使用示例

配置后，您可以询问您的AI助手：

• *“显示我太平洋时间昨天的生活日志”*
• *“我上周二在美国东部时间做了什么？”*
• *“搜索我的生活日志中提到的‘项目会议’”*
• *“获取伦敦时间2025年7月1日起的生活日志”*
• *“本周我就人工智能进行了哪些对话？”*

✅ 验证与测试

现状（2025年7月2日）

• ✅ 服务器联机: https://limitless-mcp-remote.genaijake.workers.dev
• ✅ 时区支持：IANA时区标识符工作正常
• ✅ 所有工具功能正常：get_lifelog、search_lifelogs、get_lifelog_by_id、delete_lifelog
• ✅ Claude桌面集成：本地和遗留方法都有效
• ✅ API验证：与Limitless API v1进行适当集成

测试命令

健康检查：

curl "https://limitless-mcp-remote.genaijake.workers.dev/health"

使用API密钥进行测试：

curl "https://limitless-mcp-remote.genaijake.workers.dev/test/YOUR_API_KEY"

MCP检查员：

npx @modelcontextprotocol/inspector@latest

然后连接到： https://limitless-mcp-remote.genaijake.workers.dev/sse?api_key=YOUR_API_KEY

🔧 发展

先决条件

• Node.js 18+
• Cloudflare帐户
• 牧马人CLI

地方发展

# Clone the repository
git clone https://github.com/genaijake/limitless-mcp-remote.git
cd limitless-mcp-remote

# Install dependencies
npm install

# Start development server
npm run dev

# Deploy to Cloudflare
npm run deploy

测试

测试运行状况端点：

curl https://limitless-mcp-remote.genaijake.workers.dev/health

MCP检验员测试：

npx @modelcontextprotocol/inspector@latest

然后连接到：

http://localhost:8787/{YOUR_API_KEY}/sse

🏗️ 建筑

组件

• 入口点 (src/index.ts)-带路由和CORS的Cloudflare Worker处理程序
• MCP服务器 (src/limitless-mcp.ts)-持久对象实现MCP协议
• API客户端 (src/limitless-client.ts)-适用于Limitless API v1的HTTP客户端
• 类型 (src/types.ts)-API数据的TypeScript接口

主要特点

• 有意义的会议 -每个MCP连接都有自己的持久对象
• API密钥安全 -密钥通过URL路径传递，从不存储在服务器端
• 错误处理 -包含有用消息的全面错误响应
• CORS支持 -适用于基于web的MCP客户端

🔐 安全

• ✅ API密钥经过验证，但从未存储
• ✅ 每个用户会话都通过持久对象隔离
• ✅ 对所有连接实施HTTPS
• ✅ 所有参数的输入验证
• ✅ 通过Cloudflare的基础设施进行速率限制

📖 api参考

URL格式

推荐（Firecrawl风格）:

/{YOUR_API_KEY}/sse

遗留（查询参数）:

/sse?api_key={YOUR_API_KEY}

端点

• GET / -服务器信息和使用情况
• GET /health -健康检查
• GET /{api_key}/sse -MCP连接端点
• GET /sse?api_key={key} -传统MCP连接

🤝 贡献

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

✅ 验证

有效的方法

• ✅ Firecrawl样式的URL路由(/{API_KEY}/sse)
• ✅ 无限制的API集成（使用 /test/{API_KEY})
• ✅ Cloudflare Workers部署持久对象
• ✅ API密钥验证和安全
• ✅ 使用JSON-RPC正确实现MCP协议
• ✅ 所有四个MCP工具功能齐全
• ✅ 通过适当的握手进行SSE传输

测试工具

• 健康检查: GET /health
• API连接测试: GET /test/{YOUR_API_KEY}
• MCP检查员：通过连接 /{YOUR_API_KEY}/sse

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🔗 链接

• 无限制API文件
• 模型上下文协议
• Cloudflare员工
• MCP检查员

💬 支持

• 打开一个 问题 用于错误报告
• 加入讨论 无限Slack社区
• 检查 MCP文件 有关协议详细信息

______________________________________________________________________

Built with ❤️ for the Limitless and MCP communities

🔧 客户端配置

📱 克劳德桌面

Claude Desktop现在支持远程MCP服务器的OAuth身份验证！您有两个选择：

选项1:OAuth集成（推荐）🎉

2025年的新功能：Claude Desktop现在有一个简化的集成UI！

1. 打开克劳德桌面
2. 首选 设置 → 集成
3. 点击 “添加集成” （或 “添加自定义集成”)
4. 填写：

- 集成名称: Limitless （或您喜欢的任何名称） - 集成URL: https://limitless-mcp-remote.genaijake.workers.dev

1. 点击 “添加”

就是这样！当你第一次使用Limitless工具时，Claude会：

• 自动发现OAuth配置
• 打开浏览器窗口进行身份验证
• 提示您输入Limitless API密钥
• 安全地存储OAuth令牌（API密钥从不保存在文件中）

注： 此新UI目前处于测试阶段，可用于Max、Team和Enterprise计划，Pro计划支持即将推出。

选项2：手动配置（传统）

地点：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

配置：

{
  "mcpServers": {
    "limitless-lifelog": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://limitless-mcp-remote.genaijake.workers.dev/sse?api_key=YOUR_LIMITLESS_API_KEY"
      ]
    }
  }
}

🖱️ 光标

地点： ~/.cursor/mcp.json （如果不存在则创建）

配置：

{
  "mcpServers": {
    "limitless-lifelog": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://limitless-mcp-remote.genaijake.workers.dev/mcp?api_key=YOUR_LIMITLESS_API_KEY"
      ]
    }
  }
}

单线设置： 出现提示时将其粘贴到光标中：

npx mcp-remote https://limitless-mcp-remote.genaijake.workers.dev/mcp?api_key=YOUR_LIMITLESS_API_KEY

🌊 风帆冲浪（Codeium）

地点： ~/.codeium/windsurf/mcp_config.json

配置：

{
  "mcpServers": {
    "limitless-lifelog": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://limitless-mcp-remote.genaijake.workers.dev/sse?api_key=YOUR_LIMITLESS_API_KEY"
      ]
    }
  }
}

💻 VS代码（使用GitHub Copilot）

地点： 用户设置JSON(Ctrl+Shift+P → “首选项：打开用户设置（JSON）”）

配置：

{
  "mcp": {
    "servers": {
      "limitless-lifelog": {
        "command": "npx",
        "args": [
          "mcp-remote",
          "https://limitless-mcp-remote.genaijake.workers.dev/sse?api_key=YOUR_LIMITLESS_API_KEY"
        ]
      }
    }
  }
}

🔗 Cline（VS代码扩展）

设置： 克莱恩→ MCP服务器→ 配置MCP服务器

配置：

{
  "mcpServers": {
    "limitless-lifelog": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://limitless-mcp-remote.genaijake.workers.dev/sse?api_key=YOUR_LIMITLESS_API_KEY"
      ]
    }
  }
}

⚡ Zed（预览）

设置： 助手→ 设置→ 上下文服务器→ 添加上下文服务器

配置：

• 姓名： 无限生活日志
• 命令：

npx mcp-remote https://limitless-mcp-remote.genaijake.workers.dev/sse?api_key=YOUR_LIMITLESS_API_KEY

🌐 Claude.ai（网络版）

设置： 设置→ 集成→ 添加集成

服务器URL:

https://limitless-mcp-remote.genaijake.workers.dev/mcp

web界面将自动处理OAuth身份验证！

📱 其他客户

对于上面未列出的客户端，使用以下通用模式：

对于基于JSON的配置：

{
  "limitless-lifelog": {
    "command": "npx",
    "args": [
      "mcp-remote",
      "https://limitless-mcp-remote.genaijake.workers.dev/sse?api_key=YOUR_LIMITLESS_API_KEY"
    ]
  }
}

对于单线配置：

npx mcp-remote https://limitless-mcp-remote.genaijake.workers.dev/mcp?api_key=YOUR_LIMITLESS_API_KEY

🔐 身份验证方法

OAuth 2.0（建议用于Claude Desktop）

服务器支持OAuth 2.0身份验证流，这比嵌入API密钥更安全：

1. 配置文件中没有API密钥 -更安全
2. 基于浏览器的身份验证 -在安全的web表单中输入您的API密钥
3. 基于令牌的访问 -使用临时访问令牌
4. 自动令牌刷新 -无缝的长期访问

它是如何工作的：

• Claude Desktop通过以下方式发现OAuth支持 /.well-known/mcp-oauth-metadata
• 当您使用Limitless工具时，Claude会打开 /oauth/authorize 在您的浏览器中
• 您在安全表单中输入您的Limitless API密钥
• 服务器将您的API密钥交换为OAuth令牌
• Claude只存储OAuth令牌，而不是实际的API密钥
• 所有后续请求都会自动使用OAuth令牌

API密钥验证

对于不支持OAuth的客户端，可以使用API密钥：

1. URL参数: ?api_key=YOUR_API_KEY
2. 自定义页眉: X-Limitless-API-Key: YOUR_API_KEY
3. 认证头: Authorization: Bearer YOUR_API_KEY

获取无限API密钥

1. 注册地址： 无限.ai
2. 转到您的帐户设置
3. 生成API密钥
4. 保持安全！

🛠️ 使用示例

配置后，您可以询问您的AI助手：

• *“显示我昨天的生活日志”*
• *“上周二我做了什么？”*
• *“搜索我的生活日志中提到的‘项目会议’”*
• *“删除今天早上关于咖啡的生活日志条目”*
• *“本周我就人工智能进行了哪些对话？”*

🔍 运输选项

StreamableHttp（推荐）

• 网址： /mcp?api_key=YOUR_API_KEY
• 最适合： 现代客户，更好的性能
• 支持单位： 游标、Claude.ai、VS代码、较新的MCP客户端

SSE（服务器发送事件）

• 网址： /sse?api_key=YOUR_API_KEY
• 最适合： 传统兼容性
• 支持单位： Claude Desktop、Windsurf、旧版MCP客户端

🚨 故障排除

常见问题

1.“没有可用工具”或“服务器未连接”

• 验证您的API密钥是否正确
• 检查您是否使用了正确的传输方式（SSE与StreamableHttp）
• 完全重新启动MCP客户端

2.“身份验证失败”

• 确保您的Limitless API密钥有效
• 检查API密钥中的打字错误
• 验证API密钥是否具有必要的权限

3.“找不到命令：npx”

• 从以下位置安装Node.js 18+
• 验证 npx 在您的终端中可用

4.客户特定问题：

• 克劳德桌面： 尝试OAuth集成方法，而不是手动配置
• 光标： 检查 ~/.cursor/mcp.json 存在并且是有效的JSON
• VS代码： 确保已安装GitHub Copilot扩展

调试步骤

1. 直接测试服务器：

curl "https://limitless-mcp-remote.genaijake.workers.dev/health"

1. 使用API密钥进行测试：

curl "https://limitless-mcp-remote.genaijake.workers.dev/test/YOUR_API_KEY"

1. 检查MCP连接：

npx mcp-remote https://limitless-mcp-remote.genaijake.workers.dev/sse?api_key=YOUR_API_KEY

🏗️ 发展

地方发展

# Clone the repository
git clone https://github.com/jakerains/limitless-mcp-remote.git
cd limitless-mcp-remote

# Install dependencies
npm install

# Start development server
npm run dev

部署到Cloudflare Workers

# Deploy to production
npm run deploy

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🤝 贡献

欢迎投稿！请阅读我们的投稿指南并提交pull请求。

🔗 链接

• 无限.ai： https://limitless.ai
• MCP协议： https://modelcontextprotocol.io
• Cloudflare员工： https://workers.cloudflare.com

______________________________________________________________________

需要帮助？ 在GitHub上打开问题或联系维护人员。