Linear 本地缓存的快速 MCP 服务器

关键词

本地缓存IndexedDBCRDTY.jsLLM

使用说明（Markdown格式）

  • 项目简介

    • 这是一个用于 Linear 的 MCP 服务器实现，读取 Linear.app 在本地缓存中的 IndexedDB/其他缓存数据，提供只读的上下文数据给 LLM 客户端。实现了 MCP 协议中的工具注册、请求响应等核心能力，客户端通过 MCP JSON-RPC 调用工具以获取数据。

  • 主要功能点

    • 只读 MCP 服务器：对写操作不暴露接口，确保数据安全与缓存一致性
    • 本地数据源读取：直接从 Linear 本地缓存读取数据，避免网络请求与 API 调用带来的上下文消耗
    • 工具集（Tools）：提供 list_issues、get_issue、list_teams、list_projects、list_users、list_issue_statuses、list_comments、list_initiatives、list_cycles、list_documents、get_document、list_milestones、list_project_updates 等工具，方便 LLM 获取所需信息
    • 自动检测并读取 Linear 的对象存储结构，支持多工作区和工作区内的所有工作区
    • TTL 缓存以提升性能，并保持数据的新鲜性

  • 安装步骤

    • 安装 Python 环境（推荐使用虚拟环境）
    • 安装所需依赖（包括实现 MCP 服务端所需的 mcp 库与本项目依赖的 Chromium 数据读取库）
    • 将代码放到本地目录中，确保 Python 可访问

  • 服务器配置（供 MCP 客户端了解如何接入，配置信息用于 JSON 配置 JSON 片段，注释说明如下） { "mcpServers": { "linear-fast": { "name": "Linear Local Cache", "command": "python", "args": ["-m", "linear_mcp_fast"] } // 说明：此配置用于 MCP 客户端启动服务器进程。command 指定启动解释器，args 指定脚本及参数。服务器名称 ministers 为线性本地缓存快速读取服务器。 } } 说明：MCP 客户端需要在自身配置中声明服务器信息，以便通过该命令启动和与服务器通信。上述示例中，服务器名为 linear-fast，启动命令为 python，参数为 -m linear_mcp_fast。

  • 基本使用方法

    • 启动服务器：在支持的环境下运行客户端配置中的启动命令，如上面的示例所示，使用 Python 解释器执行线性 MCP 服务器模块
    • 客户端调用：通过 MCP 客户端向服务器发送 JSON-RPC 请求调用工具，例如 list_issues、get_issue 等，获取相应数据
    • 数据更新与缓存：服务器会从 Linear 本地缓存读取数据，必要时通过 TTL 机制刷新缓存

  • 运行与调试提示

    • 确认 Linear.app 已安装并至少打开一次以生成本地缓存
    • 需要 macOS 笔记本的本地缓存路径默认在 ~/Library/Application Support/Linear/
    • 如遇缓存不同步或数据过时，可重启 Linear 应用以刷新本地缓存

  • 备注

    • 该实现为只读 MCP 服务器， Writes 应使用 Linear 的官方 MCP 服务器完成

服务器信息

访问项目