星战科技xingzhan.cloud
返回市场
线性-MCP-服务器

线性-MCP-服务器

作者：TechAIInsights0 星标更新：2025-09-16
安装使用来源：spider==github.com

项目介绍

Linear MCP 服务器

一个提供与 Linear 无缝集成的 Model Context Protocol (MCP) 服务器，用于项目和问题管理。

🚀 功能

项目管理

  • ✅ 创建项目 - 使用自定义名称、描述、优先级和内容创建新的 Linear 项目
  • ✅ 列出项目 - 获取工作区中所有项目的详细信息
  • ✅ 查看项目详情 - 检索特定项目的全面信息
  • ✅ 删除项目 - 从工作区中移除项目

问题管理

  • ✅ 创建问题 - 创建带有标题、描述、优先级和项目分配的新问题
  • ✅ 列出问题 - 查看分配给您的所有问题
  • ✅ 删除问题 - 从工作区中移除问题
  • ✅ 自动分配 - 问题会自动分配给当前用户

团队及用户管理

  • ✅ 获取团队信息 - 查看关于您的 Linear 团队的信息
  • ✅ 获取当前用户 - 显示已认证用户的详细信息
  • ✅ 默认团队 - 自动使用您的默认团队进行操作

🛠️ 可用工具

项目工具

  • create-project - 创建一个新的 Linear 项目
  • get-all-project - 列出所有项目
  • view-project-detail - 获取详细的项目信息
  • delete-project - 根据ID删除项目

问题工具

  • create-issue - 创建一个新的问题
  • get-all-issues - 列出所有分配的问题
  • delete-issue - 根据ID删除问题

团队及用户工具

  • get-team-info - 获取团队信息
  • current-user - 获取当前用户信息

📋 先决条件

  • Node.js (v16 或更高版本)
  • npm 或 yarn
  • Linear API 密钥

🔧 安装

  1. 克隆仓库：
git clone https://github.com/TechAIInsights/linear-mcp-server.git
cd linear-mcp-server
  1. 安装依赖项：
npm install
  1. 设置环境变量：
# 创建一个 .env 文件
echo "LINEAR_API_KEY=your_linear_api_key_here" > .env
  1. 获取您的 Linear API 密钥：
    • 前往 Linear 设置 > API
    • 生成一个新的 API 密钥
    • 将其添加到您的 .env 文件中

🚀 使用方法

开发模式

npm run dev

生产构建

npm run build
npm start

📁 添加服务器配置

{
  "mcpServers": {
    "linear-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/repo/dist/index.js"],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

💡 使用示例

创建项目

# 使用基本信息创建项目
create-project "我的新项目"

# 使用完整细节创建项目
create-project "高级项目" --description "一个复杂的项目" --priority "高" --content "项目详情在这里"

创建问题

# 创建基本问题
create-issue "修复身份验证错误"

# 创建带有优先级和项目的错误
create-issue "实现新功能" --priority 2 --projectId "proj_123"

管理项目

# 列出所有项目
get-all-project

# 查看项目详情
view-project-detail --id "proj_123"

# 删除项目
delete-project --id "proj_123"

🔧 配置

环境变量

  • LINEAR_API_KEY - 您的 Linear API 密钥（必需）

优先级级别

  • 0 - 无优先级
  • 1 - 紧急
  • 2 - 高
  • 3 - 正常
  • 4 - 低

🏗️ 架构

服务器采用模块化架构以提高可维护性：

  • 模块化工具 - 每个工具类别都有自己的模块
  • 标准化响应 - 所有工具的一致响应格式
  • 错误处理 - 具有上下文感知消息的全面错误处理
  • 类型安全 - 全面支持 TypeScript 和适当的类型定义

📚 开发脚本

  • npm run build - 编译 TypeScript 到 JavaScript
  • npm run start - 运行编译的应用程序
  • npm run dev - 使用热重载（HMR）运行
  • npm run dev:watch - 使用 TypeScript 编译 + nodemon 运行
  • npm run watch - 监控更改并自动重新编译
  • npm run test - 使用 Jest 运行测试
  • npm run clean - 移除编译输出

🔗 相关