Limitless MCP 服务器

使用说明

项目简介

Limitless MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端,旨在桥接 Limitless API (一个可穿戴 AI 吊坠的 API) 和大语言模型 (LLM)。它允许 LLM 通过标准的 MCP 协议访问您的 Limitless Lifelog 数据,从而为 LLM 应用提供丰富的个人上下文信息。

主要功能点

  • Lifelog 数据访问: 将您的 Limitless Lifelog 数据作为 MCP 资源托管,允许 LLM 客户端读取和利用这些数据。
  • MCP 协议支持: 实现了 MCP 协议的核心功能,能够处理 MCP 格式的请求和响应,与 MCP 客户端进行通信。
  • Go 语言实现: 使用 Go 语言开发,性能和效率较高。
  • 易于部署: 可以作为独立的服务器运行,方便集成到各种 LLM 应用环境中。

安装步骤

  1. 克隆仓库
    git clone https://github.com/manueltarouca/limitless-mcp-server
    cd limitless-mcp-server
  2. 安装 Go 依赖 确保您已安装 Go 语言环境。然后运行以下命令下载项目依赖:
    go mod download
  3. 构建服务器
    go build -o limitless-mcp-server server/main.go
    这将在当前目录下生成名为 'limitless-mcp-server' 的可执行文件。

服务器配置

MCP 客户端需要配置以下信息以连接到 Limitless MCP 服务器。以下是配置示例(JSON 格式):

{
  "serverName": "limitless-mcp-server",
  "command": "./limitless-mcp-server",
  "args": [],
  "description": "Limitless MCP 服务器,提供对 Limitless Lifelog 数据的访问。"
}

配置参数说明:

  • 'serverName': 服务器的名称,您可以自定义。
  • 'command': 启动 Limitless MCP 服务器的命令。这里假设您在 'limitless-mcp-server' 仓库根目录下运行 MCP 客户端,并且已经按照安装步骤构建了服务器可执行文件。
  • 'args': 启动服务器的命令行参数。根据仓库信息,此服务器可能不需要额外的命令行参数,因此设置为空数组 '[]'。
  • 'description': 服务器的描述信息,方便您在 MCP 客户端中识别和管理。

重要提示:

  • Limitless API 密钥: Limitless MCP 服务器需要访问 Limitless API 才能获取 Lifelog 数据。您需要设置环境变量 'LIMITLESS_API_KEY' 为您的 Limitless API 密钥。请在运行服务器之前设置此环境变量,例如:
    export LIMITLESS_API_KEY="YOUR_LIMITLESS_API_KEY"
    或者在启动服务器的脚本中设置。

基本使用方法

  1. 启动服务器: 在终端中,导航到 'limitless-mcp-server' 仓库根目录,并运行以下命令启动服务器:

    ./limitless-mcp-server

    服务器默认监听地址为 'localhost:8080'。

  2. 配置 MCP 客户端: 在您的 MCP 客户端应用中,按照客户端的配置方法,添加上面提供的服务器配置信息。确保客户端能够通过 JSON-RPC 协议连接到 'http://localhost:8080/rpc' (默认地址)。

  3. 使用 LLM 应用: 现在,您的 LLM 应用可以通过 MCP 客户端与 Limitless MCP 服务器交互,访问您的 Limitless Lifelog 数据,从而增强 LLM 的上下文理解和应用能力。

请参考 MCP 协议文档Limitless API 文档 了解更多细节。

服务器信息