无界人工智能MCP服务器

Name: 无界人工智能MCP服务器
Author: ericbuess

作者：ericbuess10 星标更新：2025-06-10

安装使用来源：spider==github.com

项目介绍

Limitless AI MCP Server

这是一个高级的模型上下文协议（MCP）服务器，它使AI助手能够与Limitless AI吊坠录音进行交互。该服务器提供了一个无缝的桥梁，连接您的AI工具和Limitless API，允许您提取见解、搜索录音并分析您的吊坠数据。

⚠️ 测试版发布：这是早期版本（v0.0.1）。虽然核心功能已经实现并经过测试，但我们需要社区反馈来验证所有功能。请报告任何问题！

🌟 功能

核心能力

完整的Limitless API集成：通过编程方式访问所有您的吊坠录音
高级搜索：使用关键词匹配搜索您的录音
灵活查询：按日期、日期范围或获取最近的录音列表
丰富的内容访问：检索markdown内容、标题和元数据
高性能：智能缓存，支持LRU淘汰和TTL
强大的错误处理：内置重试逻辑和超时管理
类型安全：全面的TypeScript支持，包含详尽的类型定义

MCP协议实现

🔧 工具：5个专门用于搜索和检索录音的工具
📁 资源：以结构化资源的形式浏览录音，并使用URI导航
📝 提示：预建模板用于常见的分析任务
🔍 抽样：AI驱动的内容分析和总结
🔎 发现：自动向MCP客户端暴露功能

📋 要求

Node.js 22+
Limitless 吊坠（必需 - API仅返回吊坠录音）
Limitless API密钥（从limitless.ai/developers获取）
兼容MCP的客户端（Claude Desktop, Windsurf, Cursor等）

🏃 快速开始

从limitless.ai/developers获取您的API密钥

克隆并构建：

git clone https://github.com/ericbuess/limitless-ai-mcp-server.git
cd limitless-ai-mcp-server
npm install
npm run build

配置Claude Code：

claude mcp add limitless -s user -e LIMITLESS_API_KEY="your-key" -- node $(pwd)/dist/index.js

开始聊天："给我看看我今天的录音"

🚀 安装

方案1：从npm安装

npm install -g limitless-ai-mcp-server

方案2：从源码安装

# 克隆仓库
git clone https://github.com/ericbuess/limitless-ai-mcp-server.git
cd limitless-ai-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

# 可选：全局链接
npm link

🔧 配置

1. 设置您的Limitless API密钥

# 添加到您的shell配置文件（.bashrc, .zshrc等）
export LIMITLESS_API_KEY="your-api-key-here"

# 可选：配置自定义设置
export LIMITLESS_TIMEOUT=120000  # 超时时间（毫秒）
export LIMITLESS_BASE_URL="https://api.limitless.ai/v1"  # 自定义API端点
export LOG_LEVEL="INFO"  # 日志级别选项：DEBUG, INFO, WARN, ERROR

# 可选：配置缓存
export CACHE_MAX_SIZE=100  # 最大缓存项数
export CACHE_TTL=300000  # 缓存生命周期（毫秒，5分钟）
export SEARCH_CACHE_MAX_SIZE=50  # 搜索缓存大小
export SEARCH_CACHE_TTL=180000  # 搜索缓存生命周期（毫秒，3分钟）

2. 配置您的MCP客户端

Claude Code CLI

如果您正在使用Claude Code（Anthropic官方CLI），运行：

# 方案1：直接使用命令（推荐）
npm install -g limitless-ai-mcp-server
claude mcp add limitless -s user -e LIMITLESS_API_KEY="your-api-key-here" -- limitless-ai-mcp-server

# 方案2：使用node和完整路径（最可靠，适用于nvm）
npm install -g limitless-ai-mcp-server
# 查找npm安装的位置：
npm list -g limitless-ai-mcp-server
# 然后使用直接路径（根据需要调整node版本）：
claude mcp add limitless -s user -e LIMITLESS_API_KEY="your-api-key-here" -- node ~/.nvm/versions/node/v22.0.0/lib/node_modules/limitless--ai-mcp-server/dist/index.js

# 方案3：使用本地安装
cd /path/to/limitless-ai-mcp-server
npm install && npm run build
claude mcp add limitless -s user -e LIMITLESS_API_KEY="your-api-key-here" -- node /path/to/limitless-ai-mcp-server/dist/index.js

# 验证是否运行
claude mcp list

# 如需移除
claude mcp remove limitless -s user

Claude Desktop配置

找到您的Claude Desktop配置文件：
- macOS：~/Library/Application Support/Claude/claude_desktop_config.json
- Windows：%APPDATA%\Claude\claude_desktop_config.json
- Linux：~/.config/Claude/claude_desktop_config.json
打开文件（如果不存在则创建），添加：

{
  "mcpServers": {
    "limitless": {
      "command": "node",
      "args": ["/path/to/limitless-ai-mcp-server/dist/index.js"],
      "env": {
        "LIMITLESS_API_KEY": "your-api-key-here"
      }
    }
  }
}

替换占位符：
- /path/to/limitless-ai-mcp-server → 您的实际安装路径（例如，/Users/yourname/limitless-ai-mcp-server）
- your-api-key-here → 您从limitless.ai/developers获取的Limitless API密钥
重启Claude Desktop以使更改生效
验证是否工作：在Claude中键入“给我看看我最近的录音”

其他MCP客户端

参考您的客户端文档以了解MCP服务器配置。

🛠️ 可用工具

1. `limitless_get_lifelog_by_id`

通过其唯一ID检索单个录音。

参数：

lifelog_id（必需）：唯一标识符
includeMarkdown：包括markdown内容（默认：true）
includeHeadings：包括标题（默认：true）

2. `limitless_list_lifelogs_by_date`

列出特定日期的所有录音。

参数：

date（必需）：日期格式YYYY-MM-DD
limit：最大结果数（最大值：100）
direction：排序顺序（'asc'或'desc'）
timezone：IANA时区
includeMarkdown：包括markdown内容
includeHeadings：包括标题

3. `limitless_list_lifelogs_by_range`

列出在指定日期/时间范围内的录音。

参数：

start（必需）：起始日期/时间
end（必需）：结束日期/时间
limit：最大结果数
direction：排序顺序
timezone：IANA时区
includeMarkdown：包括markdown内容
includeHeadings：包括标题

4. `limitless_list_recent_lifelogs`

列出最近的录音。

参数：

limit：录音数量（默认：10，最大值：100）
timezone：IANA时区
includeMarkdown：包括markdown内容
includeHeadings：包括标题

5. `limitless_search_lifelogs`

在最近的录音中搜索关键词。

参数：

search_term（必需）：要搜索的文本
fetch_limit：要搜索的最近日志数量（默认：20，最大值：100）
limit：返回的最大结果数
includeMarkdown：包括markdown内容
includeHeadings：包括标题

🔌 MCP协议特性

此服务器实现了所有五个核心MCP协议特性，提供了多种方式来访问和分析您的Limitless数据：

📁 资源

浏览并访问您的生活记录作为结构化资源。资源提供了一个类似文件系统的界面来访问您的录音。

可用URI：

lifelog://recent - 浏览最近的录音
lifelog://2024-01-15 - 浏览特定日期的录音
lifelog://2024-01-15/abc123 - 访问特定录音

在Claude中的使用：

"浏览我最近的录音"
"显示1月15日的资源"
"打开lifelog://recent"

📝 提示

预建提示模板用于常见的分析任务。每个提示都可以通过参数进行定制。

可用提示：

daily-summary - 汇总特定一天的所有录音
- 参数：date（必需）
action-items - 从录音中提取行动事项
- 参数：date 或 dateRange（可选）
key-topics - 识别讨论的主要话题
- 参数：date 或 searchTerm（可选）
meeting-notes - 将录音格式化为结构化的会议笔记
- 参数：date（必需）
search-insights - 分析搜索结果中的模式
- 参数：searchTerm（必需）

在Claude中的使用：

"使用昨天的daily-summary提示"
"提取本周的行动事项"
"显示我讨论项目的主题"

🔍 抽样

启用AI驱动的内容分析您的录音。抽样功能允许AI直接处理和分析生活记录内容。

能力：

概述长录音
提取特定信息
识别模式和趋势
从多个录音生成见解
分析情感和语气

在Claude中的使用：

"分析本周会议的情感"
"概述昨天录音的关键决策"
"找出我在讨论项目时间线时的模式"

🔎 发现

自动向MCP客户端暴露服务器功能。这使得Claude和其他工具可以理解可用的功能。

暴露的信息：

服务器名称和版本
可用工具、资源和提示
支持的功能和限制
API能力

⚡ 性能与缓存

服务器包含一个智能缓存系统以优化性能：

缓存特性：

LRU（最近最少使用）淘汰策略
可配置的TTL（生存时间）
分离的录音和搜索结果缓存
自动缓存失效
缓存统计跟踪

配置（通过环境变量）：

CACHE_MAX_SIZE - 最大缓存项数（默认：100）
CACHE_TTL - 缓存生命周期（毫秒，默认：300000 / 5分钟）
SEARCH_CACHE_MAX_SIZE - 搜索缓存大小（默认：50）
SEARCH_CACHE_TTL - 搜索缓存生命周期（毫秒，默认：180000 / 3分钟）

💡 使用示例

与Claude Desktop一起使用

一旦配置好，您可以自然地与您的Limitless数据互动：

"给我看我昨天的所有录音"

"搜索我讨论'项目时间线'的对话"

"获取ID为abc123的录音并总结关键点"

"列出我上周的录音并识别行动事项"

"周一到周三我在会议上讨论了什么？"

程序化使用

import { LimitlessClient } from 'limitless-ai-mcp-server';

const client = new LimitlessClient({
  apiKey: process.env.LIMITLESS_API_KEY,
  timeout: 120000,
});

// 获取最近的录音
const recentLogs = await client.listRecentLifelogs({ limit: 5 });

// 搜索特定内容
const results = await client.searchLifelogs({
  searchTerm: '项目更新',
  fetchLimit: 50,
});

// 按日期获取录音
const todaysLogs = await client.listLifelogsByDate('2024-01-15', {
  includeMarkdown: true,
});

🧪 开发

设置开发环境

# 安装依赖
npm install

# 在开发模式下运行
npm run dev

# 运行测试
npm test

# 运行代码检查
npm run lint

# 格式化代码
npm run format

项目结构

limitless-ai-mcp-server/
├── src/
│   ├── core/           # 核心业务逻辑
│   │   └── limitless-client.ts
│   ├── tools/          # MCP工具定义和处理器
│   │   ├── definitions.ts
│   │   ├── handlers.ts
│   │   └── schemas.ts
│   ├── types/          # TypeScript类型定义
│   │   └── limitless.ts
│   ├── utils/          # 实用函数
│   │   ├── date.ts
│   │   ├── format.ts
│   │   ├── logger.ts
│   │   └── retry.ts
│   └── index.ts        # 主服务器入口点
├── tests/              # 测试文件
├── examples/           # 使用示例
└── dist/               # 编译输出

运行测试

# 运行所有测试
npm test

# 在监视模式下运行测试
npm run test:watch

# 生成覆盖率报告
npm run test:coverage

🤝 贡献

欢迎贡献！请遵循以下步骤：

分叉仓库
创建功能分支（git checkout -b feature/amazing-feature）
提交您的更改（git commit -m '添加惊人的功能'）
推送到分支（git push origin feature/amazing-feature）
打开拉取请求

请确保：

所有测试通过
代码遵循现有风格（运行npm run lint）
为新功能添加测试
根据需要更新文档

🐛 故障排除

常见问题

"未找到生活记录"
- 确保您有来自您的Limitless吊坠的录音
- 检查您的API密钥是否有效
- 验证您查询的日期范围
超时错误
- 增加超时时间：export LIMITLESS_TIMEOUT=300000
- 减少请求的结果数量
- 检查您的互联网连接
身份验证错误
- 验证您的API密钥是否正确设置
- 确保密钥没有过期
- 在limitless.ai/developers检查API密钥权限

调试模式

启用调试日志以获取更多信息：

export LOG_LEVEL=DEBUG

Claude Desktop特定问题

MCP服务器未显示
- 确保配置文件是有效的JSON（使用JSON验证器检查）
- 验证dist/index.js的路径是绝对路径，而不是相对路径
- 确保克隆后已运行npm run build
- 完全重启Claude Desktop
"命令失败"错误
- 检查Node.js 22+是否已安装：node --version
- 验证服务器是否可以在本地正常工作：LIMITLESS_API_KEY=your-key node dist/index.js
- 检查Claude Desktop日志：帮助 → 显示日志
未返回数据
- 确认您的API密钥在limitless.ai/developers处有效
- 确保您有吊坠录音（而非应用/扩展数据）
- 尝试特定日期，您知道那天有录音

Claude Code CLI特定问题

"MCP服务器状态：失败"与npx

这是一个已知问题，其中npx无法可靠地找到使用nvm安装的全局包。

解决方案：使用直接命令或完整路径代替：

# 不要使用：-- npx limitless-ai-mcp-server
# 使用：-- limitless-ai-mcp-server
# 或：-- node ~/.nvm/versions/node/vXX.X.X/lib/node_modules/limitless-ai-mcp-server/dist/index.js

使用nvm查找正确路径
```
# 首
```

无界人工智能MCP服务器

项目介绍

Limitless AI MCP Server

🌟 功能

核心能力

MCP协议实现

📋 要求

🏃 快速开始

🚀 安装

方案1：从npm安装

方案2：从源码安装

🔧 配置

1. 设置您的Limitless API密钥

2. 配置您的MCP客户端

Claude Code CLI

Claude Desktop配置

其他MCP客户端

🛠️ 可用工具

1. limitless_get_lifelog_by_id

2. limitless_list_lifelogs_by_date

3. limitless_list_lifelogs_by_range

4. limitless_list_recent_lifelogs

5. limitless_search_lifelogs

🔌 MCP协议特性

📁 资源

📝 提示

🔍 抽样

🔎 发现

⚡ 性能与缓存

💡 使用示例

与Claude Desktop一起使用

程序化使用

🧪 开发

设置开发环境

项目结构

运行测试

🤝 贡献

🐛 故障排除

常见问题

调试模式

Claude Desktop特定问题

Claude Code CLI特定问题

1. `limitless_get_lifelog_by_id`

2. `limitless_list_lifelogs_by_date`

3. `limitless_list_lifelogs_by_range`

4. `limitless_list_recent_lifelogs`

5. `limitless_search_lifelogs`