mcpField
I
issueport

issueport

本地服务
github.com/CloudCorpRecords生产力02 周前更新
代码仓库

关于 issueport

issueport 是面向 Linear 核心团队、项目、问题和评论操作的 GraphQL 客户端及 stdio MCP 服务。它适合使用 API 密钥连接 Linear 的用户，提供 12 个工具，但不复现托管式 OAuth 服务。

主要功能

  1. 01列出和获取团队及项目
  2. 02创建项目和问题
  3. 03搜索和更新问题
  4. 04归档问题
  5. 05列出和创建评论

适用场景

  1. 01搜索 Linear 问题
  2. 02创建或更新问题
  3. 03查看或添加问题评论

MCP 相关

stdio MCP 服务提供 12 个用于 Linear 团队、项目、问题和评论的工具。调用通过 Linear GraphQL API 进行，并需要 `LINEAR_API_KEY`。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cloudcorprecords-issueport": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/issueport"
      ]
    }
  }
}
启动命令npx -y @reneturcios/issueport

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@reneturcios/issueport0.1.0
ocighcr.io/cloudcorprecords/issueport:0.1.0

工具

12

收录的工具列表 · 更新于 1 周前

参数类型必填说明
limitnumber否要返回的 issue 最大数量；未指定时默认为 50。
team_idstring否要将列表限定到的 Linear 团队 ID；未指定时，会列出所有团队的 issue。

详细介绍

issueport

将 Linear 团队、项目、问题和评论作为 MCP 工具，通过 Linear GraphQL API 进行交互。issueport 是对 Linear MCP 核心子集的全新实现，使用了新名称：根据 Linear 的公开 API 文档编写的新代码，不含复制的品牌元素。原版 Linear 服务是托管/远程服务，使用 OAuth；此重制版是使用 API 密钥连接同一上游 API 的 GraphQL 客户端，不会复现托管版的 OAuth 功能。

工具（核心子集，共 12 个）

list_issues、get_issue、create_issue、update_issue、 search_issues、list_teams、get_team、list_projects、 create_project、list_comments、create_comment、archive_issue。

此子集不包含：周期、文档、文件上传、Webhook、OAuth 应用、时间追踪、分类/自定义工作流管理、项目里程碑/标签管理、附件、通知。

每个工具对应一个 GraphQL 操作（查询或变更），以 {query, variables} 的形式发送；GraphQL errors 数组会导致调用失败，并返回第一条错误的消息。

设置

export LINEAR_API_KEY=lin_api_...

注意：Linear API 密钥会以原始形式作为 Authorization 标头的值发送，而不是作为 Bearer 令牌。也可以通过 LINEAR_API_URL 覆盖端点（默认值为 https://api.linear.app/graphql）。如果未提供密钥，每次工具调用都会失败，并指出缺少的变量。

命令行

npx @reneturcios/issueport get_issue '{"issue_id":"..."}'
npx @reneturcios/issueport mcp        # stdio MCP server

每个工具名称都是一个子命令，接受一个 JSON 对象参数。

MCP 客户端配置

{
  "mcpServers": {
    "issueport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/issueport", "mcp"],
      "env": { "LINEAR_API_KEY": "lin_api_..." }
    }
  }
}

Docker

docker run -i -e LINEAR_API_KEY ghcr.io/cloudcorprecords/issueport

开发

npm install
npm run build
npm test

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。