Linear MCP Rs

线性mcp-rs

用于Linear的Rust MCP服务器。单个~4MB二进制文件，无运行时依赖关系。

安装

gh release download --repo davidjpnelson/linear-mcp-rs -p install.sh -O- | bash

需要 .下载适用于您的OS/arch的正确二进制文件 ~/.local/bin/linear-mcp.

设置

1.线性API键

在创建个人API密钥 https://linear.app → 设置 → 安全和访问 → 个人API密钥

服务器按顺序检查这些：

1. LINEAR_API_KEY 环境变量
2. 带服务名称的macOS钥匙串条目 linear-api-key

选项A--环境变量 （添加到 ~/.zshrc):

export LINEAR_API_KEY="lin_api_your_key_here"

选项B-macOS钥匙扣:

security add-generic-password -s linear-api-key -a "$USER" -w "lin_api_your_key_here"

2.添加到您的编码代理

Claude Code

claude mcp add linear-mcp ~/.local/bin/linear-mcp

然后重新启动Claude Code。

OpenAI Codex CLI

codex mcp add linear-mcp -- ~/.local/bin/linear-mcp

或添加到 ~/.codex/config.toml （使用完整的主路径）：

[mcp_servers.linear-mcp]
command = "/Users/YOUR_USER/.local/bin/linear-mcp"

Gemini CLI

gemini mcp add --name linear-mcp -- ~/.local/bin/linear-mcp

或添加到 ~/.gemini/settings.json （使用完整的主路径）：

{
  "mcpServers": {
    "linear-mcp": {
      "command": "/Users/YOUR_USER/.local/bin/linear-mcp"
    }
  }
}

Open Code

添加 ~/.config/opencode/opencode.json （或 opencode.json 在项目根目录中，使用完整的主路径）：

{
  "mcp": {
    "linear-mcp": {
      "type": "local",
      "command": ["/Users/YOUR_USER/.local/bin/linear-mcp"]
    }
  }
}

Jules

Jules内置了线性MCP支持，不需要二进制文件。首选 Jules设置→ MCP，输入Linear API键，然后启动会话。

工具

253个工具，具有线性API的全部CRUD覆盖范围。所有人都接受人性化的输入（团队密钥如 ENG、电子邮件、州名称、项目名称、问题标识符），并自动将其解析为ID。

问题

问题关系

分诊

工作流状态

评论

反应

标签

项目

项目里程碑和更新

项目状态

项目标签

循环

举措

倡议关系

客户

客户状态

客户层次

发布

释放管道

发布阶段

发布问题

文件

团队

团队成员

用户

通知

通知订阅

视图

附件

收藏夹

模板

实体外部链接

表情符号

时间进度计划

Git自动化

电子邮件接收

历史与审计

集成和Webhooks

组织与制度

建筑

• MCP-SDK: rmcp v0.15与stdio传输
• 线性API：原始GraphQL通过 reqwest （无线性SDK）
• 传输层安全：rustls（不依赖OpenSSL）
• 缓存：用于实体解析的内存缓存（团队键→ ID，问题标识符→ UUID)
• 在线富集：在查询中内联获取的相关实体（州、受让人、标签），没有N+1

从源代码构建

需要 防锈工具链.

git clone git@github.com:davidjpnelson/linear-mcp-rs.git
cd linear-mcp-rs
cargo build --release
# Binary: target/release/linear-mcp