Tiro MCP 服务端

关键词

本地知识库向量检索语义搜索内容保存自动摘要

使用说明（简要要点，便于快速上手）

  • 项目简介
    • 该仓库实现了一个用于 Claude 桌面/代码等客户端的 MCP 服务器，核心功能包括通过工具暴露本地书库的内容、执行条目检索、获取每日摘要、以及将网页/邮件保存到本地阅读库等能力。
    • 服务器使用 FastMCP 提供 MCP 协议支持，以 JSON-RPC 风格对外服务，理论上可与任何支持 MCP 的 LLM 客户端对接。
  • 主要功能点
    • 工具（Tools）：search_articles、get_article、get_digest、get_articles_by_tag、get_articles_by_source、save_url、save_email
    • 数据/资源交互：通过本地向量检索（ChromaDB）与 SQLite 数据库提供文章、来源、标签、摘要等信息
    • 兼容性：可通过 stdio、WebSocket、SSE 等传输方式与客户端通信（README/代码中含有 stdio 示例）
    • 配置与启动：通过 tiro/mcp/server.py 提供入口，配合仓库中的配置加载和向量数据库初始化
  • 安装与运行
    • 依赖环境：需要 Python 3.x，安装依赖后即可运行 MCP 服务端
    • 启动方式（示例，与仓库 README/代码一致）
      • 直接在命令行运行（ standalone 方式）：
        • uv run tiro-mcp
        • 或 uv run python -m tiro.mcp.server
    • 运行前后准备
      • 需要 Anthropic/ Claude 相关接口的 API Key 时，请设置环境变量 ANTHROPIC_API_KEY（若使用 Haiku/Opus 相关功能会调用 Claude 模型）
      • 服务器会在启动时初始化向量存储（ChromaDB）与本地 SQLite 库，并建立所需的集合/表结构
  • 服务器配置（MCP 客户端需要配置服务器信息以建立连接）
    • 以下配置仅作示例，实际使用时请将 path、key、以及目标服务器名替换为实际环境值
    • 服务器名称: tiro
    • 启动命令与参数（示例 JSON 配置，供 MCP 客户端读取，不需要直接在服务器中修改）
    • {
    • "serverName": "tiro",
    • "command": "uv",
    • "args": ["run", "--directory", "/path/to/project-tiro", "tiro-mcp"],
    • "env": {
    • "ANTHROPIC_API_KEY": "sk-..."
    • }
    • }
    • 说明:
      • serverName 指定 MCP 客户端使用的服务器标识符，需与客户端配置中的名称一致
      • command 与 args 对应启动 MCP 服务器的命令和参数，path 需指向实际的仓库根目录
      • env 用于注入运行所需的环境变量，例如 Anthropic 的 API Key
  • 基本使用方法
    • 在本地环境中启动 MCP 服务器后，MCP 客户端即可通过 JSON-RPC 调用 tiro 的工具来访问本地资源：
      • 通过 search_articles(query) 进行语义检索
      • 通过 get_article(article_id) 获取文章完整元信息与内容
      • 通过 get_digest(digest_type) 获取日 digest 内容
      • 通过 save_url(url) 将网页保存到本地阅读库
      • 通过 save_email(file_path) 将邮件/新闻简报导入
    • 如需在 Claude Desktop/Code 等客户端上使用：
      • 将上面的配置写入对应的 MCP 服务器配置区，确保服务器可通过指定的命令启动
      • 启动后在客户端即可调用上述工具完成相应操作
  • 运行注意事项
    • 如果要完整体验文章AI元数据提取、AI 可信度分析等功能，请确保环境变量 ANTHROPIC_API_KEY 已设置并可访问 Claude/Opus 模型
    • 服务器端开启后会持续维护本地库、索引与摘要，便于 LLM 客户端在本地离线或半离线环境中获得上下文

服务器信息

访问项目