MCP 服务器

Linear MCP Server

一个 Deno 实现，使 AI 模型能够与 Linear 问题跟踪功能进行交互，支持搜索问题、读取详情、更新和评论。

README

Linear MCP 服务器

一个用于 Linear 集成的 MCP 服务器的 Deno 2.0 实现。

关于

此 MCP (模型上下文协议) 服务器为 AI 模型与 Linear 问题跟踪功能交互提供了一个标准化接口。它遵循 Actions and Effects 架构模式，以实现清晰的关注点分离和可测试性。

主要特性

用于 Linear 的标准 MCP 协议实现
支持搜索问题、读取详细信息、更新和评论
遵循函数式编程原则的清晰架构
独立运行，无需安装 Deno

开始使用

快速开始 (无需安装)

直接使用服务器，无需安装：

npx @scoutos/mcp-linear

安装选项

选项 1：使用 npm (Node.js)

# 全局安装
npm install -g @scoutos/mcp-linear

# 运行服务器
mcp-linear

选项 2：使用 Deno

如果您已安装 Deno：

# 直接运行，无需安装
deno run --allow-env --allow-stdio https://deno.land/x/mcp_linear/main.ts

# 或者安装并运行
deno install --allow-env --allow-stdio -n mcp-linear https://deno.land/x/mcp_linear/main.ts
mcp-linear

与 Claude Desktop 一起使用

将以下内容添加到您的 Claude Desktop 配置文件（通常位于 ~/.config/Claude Desktop/claude_desktop_config.json）：

{
  "mcp": {
    "servers": [
      {
        "name": "Linear",
        "command": "npx @scoutos/mcp-linear",
        "env": {
          "LINEAR_API_KEY": "your_linear_api_key_here"
        }
      }
    ]
  }
}

或者，您可以使用 Docker：

{
  "mcp": {
    "servers": [
      {
        "name": "Linear",
        "command": "docker run --rm -e LINEAR_API_KEY=your_linear_api_key_here scoutos/mcp-linear:latest"
      }
    ]
  }
}

与 Cursor 一起使用

对于 Cursor，将以下内容添加到您的设置：

{
  "ai.mcp.servers": [
    {
      "name": "Linear",
      "command": "npx @scoutos/mcp-linear",
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  ]
}

测试您的集成

要验证您的设置：

在您的 Claude Desktop 或 Cursor 设置中配置 MCP 服务器
重新启动您的应用程序
提问：“Search for Linear issues containing 'bug'”（搜索包含“bug”的 Linear 问题）
助手应检测并使用 Linear MCP 服务器来检索结果

开发

此项目使用 Deno 2.0 和 just 进行开发工作流程。

前提条件

首次设置

克隆存储库后，运行：

just post-clone

这将设置所需的 git 钩子，以确保一致的代码质量。

可用命令

# 列出所有可用命令
just

# 运行带有文件监视的开发服务器
just dev

# 启动服务器
deno task start

# 格式化代码
just fmt

# 检查代码
just lint

# 格式化和检查所有文件
just check

# 运行测试
just test
# 或
deno task test

# 检查类型
just check-types

# 设置 git 钩子（从 post-clone 自动运行）
just setup-hooks

开发者体验

此项目包括：

预提交钩子，用于自动格式化和检查暂存文件
Deno 的内置格式化程序和检查器
通过 Deno 进行类型检查

构建用于分发

构建 npm 包

要构建用于 npm 分发的包：

# 创建一个独立的执行文件
deno compile --allow-net --allow-env --output dist/mcp-linear main.ts

# 打包用于 npm 分发
# 这需要在 package.json 文件中进行其他配置

该二进制文件将在 dist 目录中可用，并且可以发布到 npm。

发布到 Deno Land

要通过 deno.land/x 提供该包：

# 确保所有测试通过
just test

# 标记一个新版本
git tag v0.1.0
git push --tags

然后按照他们的贡献指南将模块提交到 deno.land/x。

项目结构

/
├── effects/             # 核心 effect 定义和实现
│   ├── http/            # 用于 API 通信的 HTTP effects
│   ├── storage/         # 用于数据持久性的存储 effects
│   └── logging/         # 用于可观察性的日志记录 effects
├── types/               # 类型定义
├── token-sources/       # Token 源实现
├── actions/             # 业务逻辑 actions
├── mcp/                 # MCP 服务器实现
│   ├── server.ts        # 核心服务器实现
│   └── server.test.ts   # 服务器测试
├── main.ts              # 应用程序入口点
└── main.test.ts         # 主要应用程序测试