线性 MCP 服务器
一个用于线性(Linear)的模型上下文协议(MCP)服务器,为 AI 助手提供对线性项目管理功能的访问。
特性
- 资源: 访问问题、项目、团队、用户、路线图、文档、倡议等
- 工具: 创建和更新问题,管理项目,搜索,将项目链接到倡议
- 提示模板: 用于问题创建、错误报告、功能请求等的模板
安装配置
先决条件
- Node.js 18 或更高版本
- 线性 API 密钥
安装步骤
-
克隆仓库:
git clone https://github.com/yourusername/linear-mcp.git
cd linear-mcp
-
安装依赖项:
npm install
-
创建 .env
文件并添加以下内容,将 YOUR_API_KEY
换为你的实际 API 密钥:
LINEAR_API_KEY=your_api_key_here
-
启动服务器:
npm start
使用说明
通过标准输入输出运行
npm run dev
通过 HTTP 模式运行
将 SERVER_PORT
环境变量设置为所需的端口(默认是 3000),然后运行:
npm start
资源详情
核心资源
- 问题: 包括问题的创建、更新和查询。
- 项目: 包括项目的创建、更新和查询,以及将问题添加到项目中。
- 团队: 包括团队的创建、更新和查询。
- 用户: 包括用户的创建、更新和查询。
附加资源
- 路线图: 包括路线图的创建、更新和查询。
- 文档: 包括文档的创建、更新和查询。
专门资源
- 倡议: 包括倡议的创建、项目与倡议的链接,以及解除项目与倡议的关联。
工具详情
问题管理
项目管理
- 创建新项目
- 规划项目(包括问题)
- 创建项目状态更新
搜索能力
提示模板
问题相关提示
- 创建新问题: 模板帮助用户快速创建新的问题。
- 错误报告: 模板用于记录和描述软件中的错误或缺陷。
- 功能请求: 模板用于提出新功能的请求。
项目相关提示
- 创建新项目: 模板帮助用户快速开始一个新的项目。
- 项目规划: 模板用于将问题组织到项目中,进行任务分配和时间管理。
- 状态更新: 模板用于生成项目的最新进展报告。
测试方法
使用 MCP 监视器测试:
npx @modelcontextprotocol/inspector stdio -- npm start
或者在 HTTP 模式下运行时,在浏览器中打开 MCP 监视器并连接到服务器的 URL。
环境变量配置
LINEAR_API_KEY
(必填):你的线性 API 密钥
SERVER_PORT
(可选):HTTP 服务器的端口(默认为 3000)
LOG_LEVEL
(可选):日志级别(默认为 info)
许可证
MIT