使用说明
@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/
