Linear SQLite MCP 服务器

关键词

SQLiteTicketing SystemAI AssistantTools RegistryJSON-RPC

使用说明

  • 项目简介

    • 该仓库实现了一个基于 MCP（Model Context Protocol）的服务器端，用于向大语言模型客户端提供可查询的资源、可调用的工具以及可渲染的提示模板，全部通过标准的 JSON-RPC 交互进行。
    • 服务器数据存储使用 SQLite 数据库，工具实现覆盖问题、项目、团队、用户、标签、周期、评论等领域，便于 LLM 进行上下文查询与外部操作。

  • 主要功能点

    • 资源管理：提供对数据库中实体（如用户、团队、项目、问题、标签等）的查询与关联能力，便于上下文信息的读取和拼接。
    • 工具注册与执行：统一注册多类工具（Issues、Projects、Teams、Labels、Cycles、Comments、Users 等），LLM 可以调用工具并获得结果。
    • Prompt 模板与渲染：支持根据需求渲染提示模板，提供对话上下文的定制化输出。
    • MCP 交互协议实现：通过 MCP 的 ListTools 和 CallTool 两类请求，向客户端暴露工具清单并执行工具，返回结构化结果。
    • 会话与传输多样性：内置会话管理，支持基于 HTTP 的走话传输，以及初步的流式传输/SSE 风格的实现，适配不同客户端的通信方式。

  • 安装步骤

    • 将仓库中的源码克隆到本地或下载镜像。
    • 安装依赖并构建/运行：
      • 进入 sqlite-mcp-server 目录，执行 npm install。
      • 根据需要初始化数据库和表结构（示例脚本在 README/代码中给出）。
      • 启动服务，开发模式通常为 npm run dev，生产模式通常为 npm start。
    • 运行后默认提供 MCP 接口在 http://localhost:3000/mcp，可通过 MCP 客户端进行初始化与后续请求。

  • 服务器配置（MCP 客户端需要，提供示例信息）

    • 配置示例（JSON，客户端无需执行，仅用于描述服务器启动与连接信息） { "server": "linear-sqlite-mcp", "command": "node", "args": ["/path/to/sqlite-mcp-server/dist/index.js"], "env": { "DB_PATH": "/path/to/sqlite-mcp-server/linear.db", "PORT": "3000" } // 说明：DB_PATH 指向本地数据库文件路径，端口默认为 3000，启动后客户端通过 http://localhost:3000/mcp 进行连接。 }

  • 基本使用方法

    • 启动后访问健康接口，确认服务器状态。
    • 客户端通过 MCP 会话初始化建立连接，随后可通过调用工具列表获取可用工具，再按需调用工具执行操作。
    • 如需调试，可使用 curl 或 Postman 发送 JSON-RPC 请求至 /mcp，进行初始化、工具列举与工具调用等操作。

  • 进一步信息

    • 服务器提供的工具覆盖 Issues、Projects、Teams、Labels、Cycles、Comments、Users 等领域，工具的输入结构遵循 MCP 标准的 JSON 架构，返回结果以数据对象形式提供，支持错误处理与提示信息。
    • 服务器同时提供简单的 Stateless 模式作为回退场景，确保在无会话时也能处理基本请求。

服务器信息

访问项目