Limitless MCP Server - 增强版

概述

Limitless MCP服务器提供对Limitless Pendant录音中对话的高级分析，包括智能会议检测、行动项提取以及全面的数据分析。

v0.13.0 新增功能

• 完整的分页支持：所有工具现在都能正确处理大数据集并使用分页
• 移除旧功能：清理了语音活力工具，专注于核心功能
• 修复剩余工具：会议检测、行动项、记录和详细分析都使用了分页
• 性能提升：所有工具均采用一致的10项API限制以优化性能

上一版本更新（v0.12.0）

• 增强的令牌限制处理：对于超大响应进行更积极的截断
• 修复搜索工具：limitless_search_lifelogs 现在能正确处理令牌限制
• 改进响应安全性：在令牌估算前进行预置数组截断
• 更好的错误预防：所有工具现在一致地使用安全响应包装器

上一版本更新（v0.11.0）

• 令牌限制解决方案：智能分页和响应分块以处理大数据集
• 新全记录工具：limitless_get_full_transcript 自动分页获取完整数据
• 增强的分页：所有列表工具现在支持基于游标的分页以避免令牌限制
• 智能响应处理：自动检测和处理超大响应
• 多种输出格式：总结模式、全数据模式或仅记录模式以增加灵活性

上一版本更新（v0.9.0）

• 星标生活日志支持：过滤并识别标记为星号的重要对话
• 增强的错误消息：具有详细上下文的更具体错误处理
• 改进的时间区处理：强大的时间区检测回退机制
• 更新的时间戳：通过 updatedAt 字段跟踪生活日志的最后修改时间
• 完全API兼容性：现在支持官方Limitless API的所有参数

主要特性

• 智能会议检测：自动从对话中识别会议
• 行动项提取：找到带有上下文的任务和承诺
• 自然语言时间查询：使用如“昨天”、“上周”等表达式
• 高级搜索：根据相关性评分在整个历史记录中查找对话
• 每日总结：包含参与者和关键话题的综合分析
• 说话者分析：与特定人员对话的详细分析
• 智能分页：处理大数据集而不受令牌限制问题的影响
• 原始记录访问：获取精确的记录以供进一步AI处理

安装

npm install -g 199bio-mcp-limitless-server

使用方法

Claude Desktop 配置

添加到您的Claude Desktop MCP设置：

{
  "mcpServers": {
    "limitless": {
      "command": "npx",
      "args": ["199bio-mcp-limitless-server"],
      "env": {
        "LIMITLESS_API_KEY": "your-api-key-here"
      }
    }
  }
}

可用工具

高级分析工具

• 自然时间查询：limitless_get_by_natural_time
• 会议检测：limitless_detect_meetings
• 行动项提取：limitless_extract_action_items
• 详细记录：limitless_get_raw_transcript
• 每日总结：limitless_get_daily_summary
• 全记录获取器：limitless_get_full_transcript （v0.11.0 新增）

处理大数据集（v0.11.0）

MCP服务器现在能够智能处理会超过Claude令牌限制的大数据集：

分页支持

所有列表工具现在支持基于游标的分页：

# 第一次请求
limitless_list_lifelogs_by_date(date="2025-07-24", limit=10)
# 返回：10个项目 + 游标

# 下一页
limitless_list_lifelogs_by_date(date="2025-07-24", limit=10, cursor="next_page_cursor")

全记录工具

为了获取完整数据而无需手动分页：

limitless_get_full_transcript(date="2025-07-24", format="transcript_only")

可用格式：

• summary：仅关键信息（默认）
• full：包含所有字段的完整数据
• transcript_only：仅记录文本

API参考

核心类型

interface Lifelog {
  id: string;
  title?: string;
  markdown?: string;
  startTime: string;
  endTime: string;
  contents?: LifelogContentNode[];
  isStarred?: boolean;  // 新增：此生活日志是否被标记为星号
  updatedAt?: string;   // 新增：此生活日志上次更新的时间
}

interface LifelogParams {
  // ... 已有参数 ...
  isStarred?: boolean;  // 新增：仅筛选被标记为星号的生活日志
  batch_size?: number;  // 新增：用于性能调整的可配置批次大小
}

开发

从源代码构建

git clone https://github.com/199-biotechnologies/mcp-limitless-enhanced.git
cd mcp-limitless-enhanced
npm install
npm run build

测试

# 使用真实API数据测试
LIMITLESS_API_KEY=your-key npm run dev

贡献

我们欢迎任何能提高此MCP服务器功能性和可靠性的贡献。

许可证

MIT许可证 - 查看LICENSE文件了解详情。

故障排除

常见问题

“Claude达到最大长度”消息

当响应过长或对话上下文已满时，Claude Desktop的UI会显示此消息。这与：

• MCP服务器的功能无关
• 您的Claude账户级别（免费/付费）无关
• Limitless API限制无关

解决办法：开始新的对话或请求较短的响应。

服务器崩溃，显示“JSON输入意外结束”

当非JSON数据发送到服务器时会发生这种情况。MCP服务器使用JSON-RPC通过stdio通信，而不是HTTP。

常见错误：尝试使用HTTP客户端、浏览器或curl连接。 解决办法：使用Claude Desktop或适当的MCP客户端。

无法通过HTTP/浏览器/ngrok连接

MCP服务器不是HTTP服务器。它们通过stdin/stdout使用JSON-RPC进行通信。

错误示例：curl http://localhost:8008 正确示例：在Claude Desktop的MCP设置中配置

查询无返回数据

截至2025年3月，Limitless API主要展示来自Limitless Pendant的数据。确保：

• 您的Pendant正在积极录制
• 您有最近的对话数据
• 您的API密钥具有正确的权限

理解MCP服务器

MCP服务器是什么：

• 通过stdio通信的JSON-RPC服务
• 专为Claude Desktop和兼容MCP的客户端设计
• 扩展AI助手能力的工具

MCP服务器不是什么：

• HTTP/REST API
• Web服务器
• 可通过浏览器访问的服务
• 带有UI的独立应用程序

如果您需要对Limitless数据进行HTTP访问：

1. 直接使用Limitless API
2. 创建一个单独的HTTP封装服务
3. 使用官方的Limitless网络界面

支持

• 问题：GitHub Issues
• 文档：科学文档
• 联系：boris@199longevity.com