AI导哈

Limitless AI 服务器

一个基于 MCP 协议的 Limitless AI 服务器，用于管理生命日志和聊天记录，支持 Docker 和 uvx 运行。

  • by midnight480
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 midnight480/mcp-limitless-server

使用说明

MCP无限服务器

日语版在这里

MCP（模型上下文协议）服务器 无限AI API此服务器提供了通过MCP兼容客户端与您的Limitless生活日志和聊天进行交互的工具。使用Python和MCP SDK构建。

特性

  • 生活日志管理：获取、搜索和删除生活日志条目
  • 聊天管理：获取和删除聊天对话
  • 灵活过滤：支持日期/时间范围、搜索查询、分页等
  • Docker支持：作为Docker容器运行
  • uvx支持：不使用Docker运行 uvx

先决条件

  • Python 3.10或更高版本
  • Docker（可选，用于基于Docker的使用）
  • 无限制API密钥（请参见 如何获取API密钥)

安装

使用Docker（推荐）

  1. 构建Docker镜像：
docker build -t mcp-limitless-server .
  1. 运行服务器：
docker run -it --rm -e LIMITLESS_API_KEY=your-api-key-here mcp-limitless-server

使用uvx（不需要Docker）

使用安装和运行 uvx:

uvx mcp-limitless-server --api-key your-api-key-here

或者从源代码安装：

pip install -e .

然后运行：

python -m mcp_limitless_server

确保设置 LIMITLESS_API_KEY 环境变量：

export LIMITLESS_API_KEY=your-api-key-here
python -m mcp_limitless_server

如何获取API密钥

  1. 访问 无限AI
  2. 登录您的账户
  3. 导航到API设置页面
  4. 生成新的API密钥
  5. 复制API密钥并将其用作 LIMITLESS_API_KEY 环境变量或将其作为参数传递

MCP客户端配置

克劳德桌面

将以下内容添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "limitless": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "LIMITLESS_API_KEY=your-api-key-here",
        "mcp-limitless-server"
      ]
    }
  }
}

对于uvx（无Docker）：

{
  "mcpServers": {
    "limitless": {
      "command": "uvx",
      "args": [
        "mcp-limitless-server",
        "--api-key",
        "your-api-key-here"
      ]
    }
  }
}

可用工具

生活日志

  • get_lifelogs：获取具有可选筛选功能的生活日志列表

    • 支持日期/时间过滤、搜索、分页等
    • 默认情况下，返回轻量级数据（仅标题和元数据）以减小响应大小
    • 参数： timezone, date, start, end, cursor, direction, include_markdown （默认值：False）， include_headings （默认值：True）， is_starred, limit （默认值：100，最大值：100）， include_contents （默认值：False）， search

  • get_lifelog：按ID获取单个生活日志条目

    • 参数： lifelog_id （必填）， timezone, include_markdown, include_headings, include_contents

  • delete_lifelog：按ID删除生活日志条目

    • 参数： lifelog_id （必填）

聊天

  • get_chats：获取聊天列表（询问ai对话）

    • 支持分页和过滤
    • 参数： cursor, direction, limit, timezone, is_scheduled, global_prompt_id

  • get_chat：通过ID进行一次聊天

    • 参数： chat_id （必填）， timezone

  • 删除帽子：按ID删除聊天

    • 参数： chat_id （必填）

音频

  • 下载_音频：从您的吊坠下载特定时间范围内的Ogg Opus文件音频
    • 请求的时间范围必须为2小时（7200000毫秒）或更短
    • 返回base64编码的音频数据
    • 参数： start_ms （必填）， end_ms （必填）， audio_source （默认：“吊坠”）

API规范

此MCP服务器实现了Limitless API，如中所述：

速率限制

无限制API实施速率限制：

  • 默认利率限制：每个API密钥每分钟180个请求
  • 速率限制响应：超过时返回429 Too Many请求和重试信息

发展

设置

  1. 克隆存储库：
git clone <repository-url>
cd mcp-limitless-server
  1. 安装依赖项：
pip install -r requirements-dev.txt

运行测试

pytest

代码检查

ruff check .

格式化

ruff format .

项目结构

mcp-limitless-server/
├── src/
│   └── mcp_limitless_server/
│       ├── __init__.py
│       ├── __main__.py
│       ├── client.py          # Limitless API client
│       ├── models.py          # Data models
│       └── server.py          # MCP server implementation
├── tests/
│   ├── test_client.py
│   └── test_server.py
├── Dockerfile
├── pyproject.toml
├── requirements.txt
├── README.md
└── README_ja.md

许可证

MIT许可证

相关 MCP