AI导哈

Linear问题管理服务器

一个用于与Linear API交互的MCP服务器，提供管理Linear问题、项目和团队的工具。

  • by timottowitz
  • 本地部署
  • 更新于
在 GitHub 查看 timottowitz/linear-mcp

使用说明

线性MCP服务器

用于与Linear的API交互的MCP服务器。此服务器提供了一组工具，用于通过Cline管理线性问题、项目和团队。

安装指南

1.环境设置

  1. 克隆存储库
  2. 安装依赖项：
    npm install
  3. 复制 .env.example 向 .env:
    cp .env.example .env

2.身份验证

服务器支持两种身份验证方法：

API密钥（推荐）

  1. 转到线性设置
  2. 导航到“安全和访问”部分
  3. 查找“个人API密钥”部分
  4. 点击“新建API键”
  5. 给钥匙贴上描述性标签（例如“临床MCP”）
  6. 立即复制生成的令牌
  7. 将令牌添加到您的 .env 文件：
    LINEAR_API_KEY=your_api_key

OAuth流（替代方案） 未实现

  1. 在以下位置创建OAuth应用程序https://linear.app/settings/api/applications
  2. 在中配置OAuth环境变量 .env:
    LINEAR_CLIENT_ID=your_oauth_client_id
LINEAR_CLIENT_SECRET=your_oauth_client_secret
LINEAR_REDIRECT_URI=http://localhost:3000/callback

3.运行服务器

  1. 构建服务器：
    npm run build
  2. 启动服务器：
    npm start

4.临床整合

  1. 打开Cline MCP设置文件：

    • macOS： ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
    • 窗户： %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
    • Linux： ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

  2. 添加线性MCP服务器配置：

    {
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your_personal_access_token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

可用操作

服务器当前支持以下操作：

问题管理

  • ✅ 在全面的现场支持下创建问题（标题、描述、团队、项目等）
  • ✅ 更新现有问题（优先级、描述等）
  • ✅ 删除问题（单次或批量删除）
  • ✅ 过滤搜索问题
  • ✅ 将问题与项目联系起来
  • ✅ 创建父/子问题关系

项目管理

  • ✅ 创建具有相关问题的项目
  • ✅ 获取项目信息
  • ✅ 将问题与项目联系起来

团队管理

  • ✅ 获取团队信息（包括状态和工作流详细信息）
  • ✅ 访问团队状态和标签

认证

  • ✅ API密钥验证
  • ✅ 安全令牌存储

批量操作

  • ✅ 批量问题创建
  • ✅ 批量问题删除

批量更新（测试中）

  • 🚧 批量问题更新（已实现并行处理，需要测试）

发展中的特点

目前正在开发以下功能：

问题管理

  • 🚧 评论功能（添加/编辑评论、线程）
  • 🚧 复杂的搜索过滤器
  • 🚧 对大型结果集的分页支持

元数据操作

  • 🚧 标签管理（创建/更新/分配）
  • 🚧 周期/里程碑管理

项目管理

  • 🚧 项目模板支持
  • 🚧 高级项目操作

认证

  • 🚧 带有自动令牌刷新的OAuth流

性能与安全

  • 🚧 速率限制
  • 🚧 详细日志记录
  • 🚧 负载测试和优化

发展

# Install dependencies
npm install

# Run tests
npm test

# Run integration tests (requires LINEAR_API_KEY)
npm run test:integration

# Build the server
npm run build

# Start the server
npm start

集成测试

集成测试验证身份验证和API调用是否正常工作：

  1. 设置身份验证（建议测试API密钥）
  2. 运行集成测试：
    npm run test:integration

对于OAuth测试：

  1. 在中配置OAuth凭据 .env
  2. 移除 .skip 来自OAuth测试 src/__tests__/auth.integration.test.ts
  3. 运行集成测试

相关 MCP