MCP无界服务器

Name: MCP无界服务器
Author: ipvr9

作者：ipvr921 星标更新：2025-03-30

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

项目介绍

Limitless MCP Server (v0.1.0)

这是一个MCP（模型上下文协议）服务器，它通过Limitless API将您的Limitless Pendant数据连接到AI工具，如Claude、Windsurf等。它允许AI聊天界面和代理以结构化和可编程的方式与您的Lifelog进行交互。让我们朝着一个更有组织、更智能的未来迈进——一次丰富的上下文互动。

什么是MCP？
模型上下文协议是一个开放标准，用于将AI模型连接到外部工具和数据——可以将其视为AI的USB-C端口或HTTP协议——通用、可靠，并设计为可扩展。这是一个被广泛采用的标准。它支持丰富的集成、自定义工作流以及AI与您每天使用的工具之间的无缝通信。

重要提示： 截至2025年3月，Limitless API 需要通过Limitless Pendant记录的数据。此服务器依赖于从您的Limitless Pendant记录的真实数据——没有这些数据，它不会返回任何有意义的内容。确保您的Pendant已连接并正在记录。

API状态及未来计划：

官方Limitless API目前处于测试版。因此，它可能会偶尔不可靠、更改或出现临时中断。
请求大量数据（例如，列出或搜索数百条日志）有时会由于API或网络限制而导致超时错误（如504网关超时）。该服务器包括每个API调用的120秒超时以减轻这种情况，但非常大的请求仍可能失败。
Limitless API正处于积极开发中。随着官方API的新特性和改进，这个MCP服务器也将随之更新。
此MCP服务器的0.2.0版本已经在开发中，计划在未来添加更多强大的功能和潜在的新工具！

特性 (v0.1.0)

列出/获取Lifelog： 按ID、日期、日期范围或列出最近的条目检索Pendant记录。包括对排序方向的控制（asc/desc）。
搜索最近的日志： 在可配置数量的最近Pendant记录内容中执行简单的文本搜索（注意：只有最近的日志是可搜索的；不支持全历史搜索）。

使用此服务器，您可以执行诸如从您的Lifelog中提取行动项并直接发送到Notion的操作——通过Claude、ChatWise、Windsurf或其他支持MCP的AI助手/应用程序。

先决条件

Node.js（需要v18或更高版本）
npm或yarn
一个Limitless账户和API密钥（在这里获取）
一个Limitless Pendant（用于数据）
一个能够启动stdio服务器并传递环境变量的MCP客户端应用程序（例如，Claude、Windsurf、Cursor、ChatWise、ChatGPT（即将推出！））。

设置

克隆或下载此项目。
导航到目录：
```
cd mcp-limitless-server
```
安装依赖项：
```
npm install
```
构建代码：
```
npm run build
```

配置（客户端）

此服务器期望在由您的MCP客户端启动时提供LIMITLESS_API_KEY作为环境变量。

您需要在MCP客户端的设置文件中添加一个服务器配置块。以下根据您是将其添加为第一个服务器还是与现有服务器一起添加提供了两个示例。

示例A：添加为第一个/唯一服务器

如果客户端的配置文件当前具有空的mcpServers对象（"mcpServers": {}），替换为以下内容：

{
  "mcpServers": {
    "limitless": {
      "command": "node",
      "args": ["<FULL_FILE_PATH_TO_DIST_SERVER.js>"],
      "env": {
        "LIMITLESS_API_KEY": "<YOUR_LIMITLESS_API_KEY_HERE>"
      }
    }
  }
}

示例B：添加到现有服务器

如果您的mcpServers对象已经包含其他服务器（如"notion": {...}），将"limitless"块与它们一起添加，确保正确的JSON语法（条目之间有逗号）：

{
  "mcpServers": {
    "some_other_server": {
      "command": "...",
      "args": ["..."],
      "env": {
        "EXAMPLE_VAR": "value"
      }
    },
    "limitless": {
      "command": "node",
      "args": ["<FULL_FILE_PATH_TO_DIST_SERVER.js>"],
      "env": {
        "LIMITLESS_API_KEY": "<YOUR_LIMITLESS_API_KEY_HERE>"
      }
    }
  }
}

重要事项：

将<FULL_FILE_PATH_TO_DIST_SERVER.js>替换为构建的服务器脚本的正确绝对路径（例如，/Users/yourname/Documents/MCP/mcp-limitless-server/dist/server.js）。相对路径可能无法可靠地工作，具体取决于客户端。
将<YOUR_LIMITLESS_API_KEY_HERE>替换为您实际的Limitless API密钥。
MCP配置文件不能包含注释。移除任何占位符文本如<YOUR_LIMITLESS_API_KEY_HERE>并替换为您的实际密钥。

运行服务器（通过客户端）

不要直接运行npm start。

确保服务器成功构建（npm run build）。
如上所示配置您的MCP客户端。
启动您的MCP客户端应用程序。当需要时，它将自动启动mcp-limitless-server进程。

暴露的MCP工具 (v0.1.0)

（参见src/server.ts或通过您的客户端询问服务器以获取完整详情。）

limitless_get_lifelog_by_id：按特定ID检索单个Pendant记录。
limitless_list_lifelogs_by_date：列出特定日期的Pendant记录。
limitless_list_lifelogs_by_range：列出在日期/时间范围内的Pendant记录。
limitless_list_recent_lifelogs：列出最近的Pendant记录。
limitless_search_lifelogs：搜索最近Pendant记录的标题/内容（有限范围！）。

注意事项及限制

🚫 需要Pendant
此服务器依赖于由Limitless Pendant生成的数据。

🧪 API测试版状态
Limitless API处于测试版阶段，可能会偶尔不稳定或受到速率限制。大型请求可能导致超时（例如，504错误）。

🔍 搜索范围
limitless_search_lifelogs仅扫描一定数量的最近日志（默认20，最大100）。它不会搜索您的完整历史记录——首先使用列表工具进行更广泛的分析。

⚠️ 错误处理及超时
API错误会被转换为MCP错误结果。每个API调用都有120秒的超时。

🔌 传输
此服务器使用stdio，并且旨在由兼容MCP的客户端应用程序启动。

贡献

有任何想法、改进或反馈吗？随时打开问题或PR——我们欢迎所有贡献！让我们继续推动可穿戴上下文和智能工具的可能性边界。https://github.com/ipvr9/mcp-limitless-server