Back to MCP directory
publicPublicdnsLocal runtime

mcp-server-linear

这是一个MCP服务器项目,提供了通过MCP客户端与Linear交互的工具,包括搜索、创建、更新问题等功能,支持Bun和Node运行环境,并可编译为独立可执行文件。

article

README

🚀 mcp-server-linear

mcp-server-linear 是一个用于与 Linear 交互的 MCP 服务器工具。借助该服务器,你能够通过客户端对 Linear 进行各种操作。

🚀 快速开始

此项目推荐使用 Bun 运行,无需转译,操作简单便捷。若你想使用 Node 运行也完全可行。以下为你提供不同运行方式的具体命令:

使用 Bun 运行

bun run index.ts

使用 Node 运行

node build/index.js

编译为独立可执行文件

Bun 项目可编译为独立的可执行文件,理论上无需安装 Bun 即可运行服务器。编译命令如下:

bun build:standalone

你可能需要根据构建目标机器的不同,调整构建的 target。更多细节请参考 Bun 文档

✨ 主要特性

当前功能

  • linear-search-issues:在 Linear 中搜索问题

未来计划的功能

  • linear-create-issue:创建 Linear 中的一个问题
  • linear-update-issue:更新 Linear 中的一个问题
  • linear-get-issue:获取 Linear 中的一个问题
  • linear-get-project-issues:获取项目中的所有问题(在 Linear 中)
  • linear-add-comment:在 Linear 的问题上添加评论
  • linear-create-project:创建一个新的项目(在 Linear 中)
  • linear-update-project:更新一个项目(在 Linear 中)

未来计划的资源

  • linear-issue:///{issueId}:查看单个问题的详细信息
  • linear-project:///{projectId}:查看项目的详细信息
  • linear-cycle:///{cycleId}:查看周期的详细信息(默认为当前周期)
  • linear-team:///{teamId}/issues:查看团队的问题
  • linear-user:///{userId}/assigned:查看用户的分配问题
  • linear-organization::查看组织信息

📦 安装指南

通过 JSON 添加到你的 MCP 客户端

为了将此服务器添加到你的 MCP 客户端中,你可以根据不同的运行方式,使用以下 JSON 配置:

使用 Bun 运行时

"linear": {
  "command": "bun",
  "args": [
    "run",
    "/path/to/linear-mcp-server/index.ts"
  ],
  "env": {
    "LINEAR_API_KEY": "lin_api_ABCD"
  }
}

使用 Node 运行时

"linear": {
  "command": "node",
  "args": [
    "/path/to/linear-mcp-server/build/index/js"
  ],
  "env": {
    "LINEAR_API_KEY": "lin_api_ABCD"
  }
}

独立可执行文件

"linear": {
  "command": "/path/to/linear-mcp-server/standalone-linear-mcp-server",
  "args": [],
  "env": {
    "LINEAR_API_KEY": "lin_api_ABCD"
  }
}

📄 许可证

本项目采用 MIT 许可证。

致谢

这个项目受到了 jerhadf/linear-mcp-server 的启发。由于我和其他人遇到了一些问题,这促使我创建了自己的实现。该项目的功能列表值得保留。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client