返回 MCP 目录
public公开dns本地运行

Linear MCP Server

一个基于Node.js的Linear问题跟踪系统的MCP服务器实现,提供标准化接口让AI模型与Linear功能交互。

article

README

🚀 线性 MCP 服务器

本项目是一个使用 Node.js 实现的线性集成 MCP 服务器,为与线性问题跟踪功能交互的 AI 模型提供了标准化接口,有效解决了模型与线性系统交互的兼容性问题,提升了交互效率和准确性。

🚀 快速开始

此 MCP(模型上下文协议)服务器为与线性问题跟踪功能交互提供标准化接口的 AI 模型提供了一个标准界面。

先决条件

  • Node.js(v18 或更高版本)
  • 线性 API 密钥

安装

  1. 克隆仓库
  2. 安装依赖项
npm install
  1. 在根目录下创建一个 .env 文件,其中包含您的线性 API 密钥
LINEAR_API_KEY=your_linear_api_key_here

运行服务器

  • 启动服务器:
npm start
  • 用于开发的文件监视:
just dev
  • 带调试日志的开发:
just debug
  • 或者手动设置环境变量:
LOG_LEVEL=DEBUG NODE_ENV=development node src/index.js

日志将写入 logs/mcp-linear.log 文件以避免干扰 STDIO 传输。

✨ 主要特性

  • 使用官方 MCP SDK 实现线性标准 MCP 协议
  • 支持搜索问题、读取详细信息、更新和评论

🔧 技术细节

结构

  • effects:包含实际执行副作用操作的模块,例如与线性 API 的交互和安全的日志记录。
  • tools:通过 MCP 协议暴露给客户端的工具,每个工具都有输入验证和文档说明。
  • utils:包含配置加载和其他通用功能的实用程序。

🤝 贡献

欢迎贡献!请随时提交 Pull Request。

📄 许可证

本项目根据 MIT 许可证发布 - 有关详细信息,请参阅 LICENSE 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端