Advanced Limitless MCP Server (v0.3.1) 🚀

Limitless MCP 服务 - 增强版

概述

一个模型上下文协议 (MCP) 服务，可对 Limitless Pendant 录音中的对话进行高级分析，具备智能会议检测、行动项提取和全面的分析能力。

v0.13.0 的新增内容

• 完整分页支持：所有工具现在都能通过分页正确处理大型数据集
• 移除遗留功能：清理了语音活力工具，专注于核心功能
• 修复其余工具：会议检测、行动项、转录文本和详细分析均使用分页
• 提升性能：所有工具统一采用 10 条目的 API 限制，以实现最佳性能

此前的更新 (v0.12.0)

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

此前的更新 (v0.11.0)

• Token 限制解决方案：智能分页和响应分块，以处理大型数据集
• 新的完整转录文本工具：limitless_get_full_transcript 可通过自动分页获取完整数据
• 增强分页：所有列表工具现在都支持基于游标的分页，以避免 Token 限制
• 智能响应处理：自动检测并处理超大响应
• 多种输出格式：摘要、完整数据或仅转录文本模式，灵活可选

此前的更新 (v0.9.0)

• 星标 Lifelog 支持：筛选并识别标记了星标的重要对话
• 增强错误消息：更具体的错误处理，提供详细的上下文
• 改进时区处理：稳健的时区检测回退机制
• 更新的时间戳：通过 updatedAt 字段跟踪 lifelog 的最后修改时间
• 完整 API 对齐：现在支持 100% 的官方 Limitless API 参数

主要功能

• 智能会议检测：自动从对话中识别会议
• 行动项提取：结合上下文查找任务和承诺
• 自然语言时间查询：使用诸如 "yesterday"、"last week" 之类的表达
• 高级搜索：在所有历史记录中查找对话，并进行相关性评分
• 每日摘要：提供包含参与者和关键主题的全面分析
• 说话人分析：对与特定人员的对话进行详细分析
• 智能分页：处理大型数据集时不会出现 Token 限制问题
• 原始转录文本访问：获取精确的转录文本，以便进一步进行 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 Token 限制的大型数据集：

分页支持

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

# First request
limitless_list_lifelogs_by_date(date="2025-07-24", limit=10)
# Returns: 10 items + cursor

# Next page
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;  // NEW: Whether this lifelog is starred
  updatedAt?: string;   // NEW: When this lifelog was last updated
}

interface LifelogParams {
  // ... existing params ...
  isStarred?: boolean;  // NEW: Filter for starred lifelogs only
  batch_size?: number;  // NEW: Configurable batch size for performance tuning
}

开发

从源码构建

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

测试

# Test with real API data
LIMITLESS_API_KEY=your-key npm run dev

贡献

我们欢迎能改进此 MCP 服务功能和可靠性的贡献。

许可证

MIT 许可证 - 详见 LICENSE 文件。

故障排查

常见问题

“Claude hit max length” 消息

此消息来自 Claude Desktop 的 UI，当回复过长或对话上下文即将占满时会出现。它与以下内容无关：

• MCP 服务的功能
• 你的 Claude 账户等级（免费/付费）
• Limitless API 限制

解决方法：开始新对话，或要求更简短的回复。

服务崩溃并提示 “Unexpected end of JSON input”

当向服务发送非 JSON 数据时会发生此情况。MCP 服务通过 stdio 使用 JSON-RPC，而不是 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 key 具有相应权限

了解 MCP 服务

MCP 服务是：

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

MCP 服务不是：

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

如果你需要通过 HTTP 访问 Limitless 数据：

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

支持

• 问题反馈：GitHub Issues
• 文档：Scientific Documentation
• 联系方式：[email protected]