🚀 线性 MCP 服务器
线性 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 许可证。