linear-mcp-server

🚀 线性 MCP 服务器

本项目是一个模型上下文协议 (MCP) 服务器，提供了与 Linear 的 API 交互的工具。借助它，AI 代理能够通过 Linear 平台对问题、项目和团队进行编程管理，为项目的自动化管理提供了便利。

🚀 快速开始

1. 从 Linear 的开发者设置 获取您的 Linear API 密钥。
2. 使用您的 API 密钥运行：

LINEAR_API_KEY=your-api-key npx @ibraha7m/linear-mcp-server

✨ 主要特性

• 问题管理
  • 可创建新的问题，并且带有可自定义属性，如标题、描述、团队、分配人、优先级、标签等。
  • 能列出问题，还带有灵活的过滤选项，例如团队、分配人、状态。
  • 支持更新现有问题的相关信息，包括标题、描述、状态、分配人、优先级。
• 团队管理
  • 可列出工作区中的所有团队。
  • 能访问团队详细信息，包括 ID、名称、密钥和描述。
• 项目管理
  • 可列出所有项目，还能选择团队进行过滤。
  • 能查看项目详细信息，包括名称、描述、状态和关联的团队。

📦 安装指南

先决条件

• Node.js (v16 或更高版本)
• 带有 API 访问权限的 Linear 账户
• 带适当权限的 Linear API 密钥

安装命令

通过 npm 安装：

npm install -g @ibraha7m/linear-mcp-server

💻 使用示例

基础用法

# 开发模式（自动重建）
npm run dev

# 生产模式
npm start

高级用法

创建问题

{
  "command": "createIssue",
  "arguments": {
    "title": "问题标题",
    "description": "问题描述",
    "projectId": "项目 ID",
    "priority": 1,
    "assigneeId": "分配人 ID"
  }
}

更新问题

{
  "command": "updateIssue",
  "arguments": {
    "issueId": "问题 ID",
    "title": "新标题",
    "description": "新描述",
    "status": "新状态",
    "assigneeId": "新分配人 ID",
    "priority": 2
  }
}

🔧 技术细节

• 使用 TypeScript 和 Linear SDK (@linear/sdk v37.0.0)
• MCP SDK (@modelcontextprotocol/sdk v0.6.0)

服务器使用标准输入输出进行通信，并实现模型上下文协议以实现与 AI 代理的无缝集成。

📄 许可证

MIT

⚠️ 重要提示

这是一个自定义实现。有关官方 Cline 线性 MCP 服务器，请参见 cline/linear-mcp。