内容
线性协议服务器
模型上下文协议（MCP） Linear API 交互。该服务器通过标准化的 MCP 接口提供访问和操作 Linear项目和其他数据的工具和资源。
## 概述
`-server-linear` 项目作为客户端应用程序（特别是 AI 工具）与 Linear 之间的桥梁，提供了一个标准化的接口来访问和操作 Linear 资源。
主要功能：
- 标准化的 Linear 资源访问（问题、项目、计划、团队）
- 问题和评论的完整 CRUD 操作
- 高级问题过滤和搜索功能
- 一致的错误处理和响应格式
- 通过协议与 AI 助手集成
## 配置
### Linear份验证
该服务器身份验证方法：
#### 选项 1：API 密钥身份验证
您可以设置 `_KEY` 环境变量：
1. 访问 [Linear 设置 > API](https://linear.app/settings/api)
2. 在“个人 API”下，点击“创建3. 为您的密钥命名，“MCP 服务器”）
4.生成的 API 密钥
5. 在运行服务器时设置环境变量
#### 选项 2：OAuth 身份验证
或者，您可以通过设置以下环境变量来使用 OAuth 身份验证：
1. 在 [Linear 设置 > API > 应用程序://linear/applications创建 OAuth 应用程序
2. 配置您的应用程序并获取客户端客户端密钥
3. 设置以下环境变量：
```bash
LINEAR_OAUTH=您的_oauth_客户端_id
LINEAR_OAUTH_CLIENT_SECRET=您的_oauth_客户端_密钥
```
如果两种身份验证方法都已配置，则优先使用 OAuth 身份验证。
或者，您可以在 shell 配置文件或使用 `dotenv` 等工具中设置环境变量。
## 使用
### 启动服务器
您可以在不全局安装的情况下直接使用 npx 运行 MCP 服务器：
```bash
LINEAR_API_KEY=您的_api_ere npx -mkusaka-server-linear
```
### 与 MCP 客户端集成 MCP 服务器可以与各种助手和 MCP 兼容的客户端集成：
#### Anthropic Claude 集成
您可以通过各种客户端将此 MCP 服务器与 Anth 结合使用：
##### Cline（VS Code 扩展）
[Cline](https://github.com/saoudrizwan/cline) 是一个 VS Code 扩展，允许您将 MCP 服务器与 Claude AI 结合使用：
1. 打开 Cline MCP 设置文件：
- macOS：`~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings - Windows：`%APPDCode/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
- Linux：`~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
2. 添加 Linear MCP 服务器配置：
```json
{
"Servers": {
"linear": {
"command": "npx",
"args": ["-y", "@mkusaka/mcp-server-linear"],
"env": {
"LINEAR_API_KEY": "您的_linear_api_密钥"
// 或使用 OAuth 身份验证时
// "LINEAR_OAUTH_CLIENT_ID": "您的_oauth_id",
//_OAUTH_CLIENT_SECRET您的_oauth_密钥"
},
"disabled": false,
Approve": []
}
}
```
##### Cursor
Cursor 配置文件（`~/.cursor/config.json`）中添加以下内容：
```json
{
"mcpServers": {
"linear": {
"command": "npx",
"args": [" "@mk/mcp-server-linear"],
"env": {
"LINEAR_API_KEY": "您的_linear_api_密钥"
// 或使用 OAuth 身份验证时
// "LINEAR_OAUTH_CLIENT_ID": "您的_oauth_客户端_id",
// "LINEAR_OAUTH_CLIENT_SECRET": "您的_oauth_客户端_密钥"
},
"disabled": false,
"autoApprove": []
}
}
}
```
### 可用工具
该 MCP 服务器提供以下工具：
#### 问题管理
- `create_issue` - 在 Linear 中创建新问题
- `update_issue` - 更新现有问题
- `delete_issue` - 删除现有问题
- `update_issue_labels` - 更新问题的标签
- `update_issue_priority` - 更新问题的- `updateestimate` - 更新问题的估算值
- `_state` - 更新问题的状态
- `search_issues` - 使用高级过滤选项搜索#### 评论管理
- `create_comment` - 在问题上创建新评论
- `update_comment` - 更新现有评论
- ` - 删除现有评论
- `get_issue_comments` - 获取特定问题的评论
#### 资源访问
- `projects` - 获取 Linear 中的所有项目
- `project` - 通过 ID 获取单个项目
-` - 通过 ID 获取单个问题
- `project_status - 获取所有项目状态 `project_issues` - 获取项目中的所有问题
- `issue_labels 获取所有问题标签
_states`所有可用的问题状态
- `get_viewer` - 获取当前用户信息，包括团队
- `update_project_state`项目的状态
## 架构
该服务器遵循模型上下文MCP）架构，提供一种标准化的方式来访问。关键的架构决策包括：
1. **资源组织**：资源按域组织在单独的文件中
2. **错误处理**：所有资源的一致错误处理
3. **响应格式**：一致的 JSON 响应格式
有关架构的更多详细信息，请参阅 [adr.md](adr.md)。
## 开发
```bash
# 运行测试
pnpm test
# 构建项目
pnpm run build
# 监视更改
pnpm run watch
# 运行调试
run debug
```
在开发和测试可以使用 MCP 检查工具与服务器交互：
```bash
# 全局安装 MCP 检查工具
pnpm install -g @modelcontextprotocol/inspector
# 运行服务器并使用检查工具
LINEAR_API_KEY=您的_api_密钥_here mcp-inspector /path/to/mcp-server-linear/dist/index.js
使用 nLINEAR_API_KEY=您的_api_密钥_here npx -y @modelcontextprotocol/inspector @mkusaka/mcp-server-linear
```
### 命令行选项
```bash 启用日志记录（默认记录到 linear-mcp.log）
pnpm run start --
日志记录并日志文件路径
pnpm run startdebug
MCP 市场
