linear-integration-server

🚀 Linear MCP 服务器

这是一个用于 Linear API 的 Model Context Protocol 服务器，实现了与 Linear 问题跟踪系统的集成，允许大语言模型 (LLM) 与其交互。

🚀 快速开始

本服务器可助力大语言模型与 Linear 问题跟踪系统交互，下面为你介绍安装和使用方法。

✨ 主要特性

• 实现与 Linear 问题跟踪系统的集成，让大语言模型能够与之交互。
• 提供多个实用工具，可对 Linear 问题进行创建、更新、搜索等操作。

📦 安装指南

使用 Smithery 安装

通过 Smithery 自动安装 Linear Integration Server for Claude Desktop：

npx -y @smithery/cli install @gerbal/linear-mcp-server-1 --client claude

手动安装

1. 为您的团队创建或获取一个 Linear API 密钥：https://linear.app/YOUR-TEAM/settings/api
2. 将服务器配置添加到 Claude Desktop：
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-linear"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

💻 使用示例

组件工具使用

linear_create_issue

创建新的 Linear 问题：

# 示例代码，假设使用 Python 调用
import requests

url = "your_server_url"
data = {
    "title": "New Issue Title",
    "teamId": "your_team_id"
}
response = requests.post(url, json=data)
print(response.json())

linear_update_issue

更新现有问题：

import requests

url = "your_server_url"
data = {
    "id": "issue_id_to_update",
    "title": "New Title"
}
response = requests.post(url, json=data)
print(response.json())

工具详情

工具列表

| 工具名称 | 功能 | | ---- | ---- | | linear_create_issue | 创建新的 Linear 问题 | | linear_update_issue | 更新现有问题 | | linear_search_issues | 使用灵活过滤搜索问题 | | linear_get_user_issues | 获取用户分配的问题 | | linear_add_comment | 在问题上添加评论 |

linear_create_issue 参数详情

| 参数类型 | 参数名称 | 详情 | | ---- | ---- | ---- | | 必填参数 | title | 问题标题（字符串） | | 必填参数 | teamId | 要创建问题的团队 ID（字符串） | | 可选参数 | description | 问题描述（支持 Markdown，字符串） | | 可选参数 | priority | 优先级级别（数字, 0 - 4，1=紧急，4=低） | | 可选参数 | status | 初始状态名称（字符串） |

linear_update_issue 参数详情

| 参数类型 | 参数名称 | 详情 | | ---- | ---- | ---- | | 必填参数 | id | 要更新的问题 ID（字符串） | | 可选参数 | title | 新标题（字符串） | | 可选参数 | description | 新描述（字符串） | | 可选参数 | priority | 新优先级（数字） | | 可选参数 | status | 新状态名称（字符串） |

linear_search_issues 参数详情

| 参数类型 | 参数名称 | 详情 | | ---- | ---- | ---- | | 可选参数 | query | 要在标题/描述中搜索的文本（字符串） | | 可选参数 | teamId | 按团队过滤（字符串） | | 可选参数 | status | 按状态过滤（字符串） | | 可选参数 | assigneeId | 按分配人过滤（字符串） | | 可选参数 | labels | 按标签过滤（字符串数组） | | 可选参数 | priority | 按优先级过滤（数字） | | 可选参数 | limit | 最大结果数（数字，默认值为 10） |

linear_get_user_issues 参数详情

| 参数类型 | 参数名称 | 详情 | | ---- | ---- | ---- | | 可选参数 | userId | 用户 ID（省略以表示已验证的用户，字符串） | | 可选参数 | includeArchived | 包含存档的问题（布尔值） | | 可选参数 | limit | 最大结果数（数字，默认值为 50） |

linear_add_comment 参数详情

| 参数类型 | 参数名称 | 详情 | | ---- | ---- | ---- | | 必填参数 | issueId | 要评论的问题 ID（字符串） | | 必填参数 | body | 评论内容（支持 Markdown，字符串） | | 可选参数 | createAsUser | 以哪个用户的身份创建（字符串） | | 可选参数 | anonymous | 是否匿名（布尔值） |

资源

• Linear API 文档

🔧 技术细节

开发步骤

1. 安装依赖：

npm install

2. 在 .env 中配置 Linear API 密钥：

LINEAR_API_KEY=your_api_key_here

3. 构建服务器：

npm run build

对于开发时的自动重建：

npm run watch

📄 许可证

此 MCP 服务器根据 MIT License 发布。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT License 的条款和条件。有关详细信息，请参阅项目仓库中的 LICENSE 文件。