Linear MCP服务器

一个定制的Linear MCP服务器,通过优化的GraphQL查询提高AI上下文的效率,减少约80%的上下文使用。

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

使用说明

@hatcloud/线性mcp

自定义线性MCP服务器,具有优化的GraphQL查询,可提高AI上下文效率。

为什么?

官方的Linear MCP返回完整的问题对象。此服务器使用有针对性的GraphQL字段选择,将上下文使用率降低了约80%。

安装

添加到MCP配置(~/.claude/mcp.json 或同等):

{
  "linear": {
    "command": "npx",
    "args": ["-y", "@hatcloud/linear-mcp"],
    "env": {
      "LINEAR_API_KEY": "lin_api_your_key_here"
    }
  }
}

工具

20个工具,涵盖问题、评论、文档、附件、项目和团队。

问题

工具 说明
get_issue 完整的问题详细信息,包括可选的注释和子问题(单个复合查询)
list_issues 列出过滤器的问题(项目、受让人、州、父级、优先级、标题)
search_issues 使用可选筛选器按标题搜索问题
create_issue 创建新问题
update_issue 更新现有问题的任何字段
archive_issue 存档问题
get_status_map 将状态名称映射到团队的UUID

评论

工具 说明
list_comments 列出对某个问题的评论
get_comment 按ID获取单个评论
create_comment 向问题添加评论

文件

工具 说明
list_documents 列出项目中的文档
create_document 创建文档,可选择链接到问题
update_document 更新文档的标题或内容
delete_document 删除文档

附件

工具 说明
list_attachments 列出问题的附件
create_attachment 在问题上创建URL附件

项目和团队

工具 说明
list_teams 列出所有团队
list_projects 列出项目,可选择按团队筛选
create_project 创建新项目
update_project 更新项目

环境变量

变量 必填 描述
LINEAR_API_KEY 是 您的线性API键(来自线性设置→ API

发展

npm test          # Run unit tests
npm run build     # Build to dist/