🚀 Linear MCP 服务器
这是一个用于 Linear API 的 Model Context Protocol 服务器，实现了与 Linear 问题跟踪系统的集成，允许大语言模型 (LLM) 与其交互。
🚀 快速开始
本服务器可助力大语言模型与 Linear 问题跟踪系统交互，下面为你介绍安装和使用方法。
✨ 主要特性
- 实现与 Linear 问题跟踪系统的集成，让大语言模型能够与之交互。
- 提供多个实用工具，可对 Linear 问题进行创建、更新、搜索等操作。
📦 安装指南
使用 Smithery 安装
通过 Smithery 自动安装 Linear Integration Server for Claude Desktop：
npx -y @smithery/cli install @gerbal/linear-mcp-server-1 --client claude
手动安装
- 为您的团队创建或获取一个 Linear API 密钥：https://linear.app/YOUR-TEAM/settings/api
- 将服务器配置添加到 Claude Desktop：
- MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- MacOS:
{
"mcpServers": {
"linear": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-linear"
],
"env": {
"LINEAR_API_KEY": "your_linear_api_key_here"
}
}
}
}
💻 使用示例
组件工具使用
linear_create_issue
创建新的 Linear 问题：
# 示例代码，假设使用 Python 调用
import requests
url = "your_server_url"
data = {
"title": "New Issue Title",
"teamId": "your_team_id"
}
response = requests.post(url, json=data)
print(response.json())
linear_update_issue
更新现有问题：
import requests
url = "your_server_url"
data = {
"id": "issue_id_to_update",
"title": "New Title"
}
response = requests.post(url, json=data)
print(response.json())
工具详情
工具列表
| 工具名称 | 功能 |
|---|---|
linear_create_issue |
创建新的 Linear 问题 |
linear_update_issue |
更新现有问题 |
linear_search_issues |
使用灵活过滤搜索问题 |
linear_get_user_issues |
获取用户分配的问题 |
linear_add_comment |
在问题上添加评论 |
linear_create_issue 参数详情
| 参数类型 | 参数名称 | 详情 |
|---|---|---|
| 必填参数 | title |
问题标题（字符串） |
| 必填参数 | teamId |
要创建问题的团队 ID（字符串） |
| 可选参数 | description |
问题描述（支持 Markdown，字符串） |
| 可选参数 | priority |
优先级级别（数字, 0 - 4，1=紧急，4=低） |
| 可选参数 | status |
初始状态名称（字符串） |
linear_update_issue 参数详情
| 参数类型 | 参数名称 | 详情 |
|---|---|---|
| 必填参数 | id |
要更新的问题 ID（字符串） |
| 可选参数 | title |
新标题（字符串） |
| 可选参数 | description |
新描述（字符串） |
| 可选参数 | priority |
新优先级（数字） |
| 可选参数 | status |
新状态名称（字符串） |
linear_search_issues 参数详情
| 参数类型 | 参数名称 | 详情 |
|---|---|---|
| 可选参数 | query |
要在标题/描述中搜索的文本（字符串） |
| 可选参数 | teamId |
按团队过滤（字符串） |
| 可选参数 | status |
按状态过滤（字符串） |
| 可选参数 | assigneeId |
按分配人过滤（字符串） |
| 可选参数 | labels |
按标签过滤（字符串数组） |
| 可选参数 | priority |
按优先级过滤（数字） |
| 可选参数 | limit |
最大结果数（数字，默认值为 10） |
linear_get_user_issues 参数详情
| 参数类型 | 参数名称 | 详情 |
|---|---|---|
| 可选参数 | userId |
用户 ID（省略以表示已验证的用户，字符串） |
| 可选参数 | includeArchived |
包含存档的问题（布尔值） |
| 可选参数 | limit |
最大结果数（数字，默认值为 50） |
linear_add_comment 参数详情
| 参数类型 | 参数名称 | 详情 |
|---|---|---|
| 必填参数 | issueId |
要评论的问题 ID（字符串） |
| 必填参数 | body |
评论内容（支持 Markdown，字符串） |
| 可选参数 | createAsUser |
以哪个用户的身份创建（字符串） |
| 可选参数 | anonymous |
是否匿名（布尔值） |
资源
🔧 技术细节
开发步骤
- 安装依赖：
npm install
- 在
.env中配置 Linear API 密钥：
LINEAR_API_KEY=your_api_key_here
- 构建服务器：
npm run build
对于开发时的自动重建：
npm run watch
📄 许可证
此 MCP 服务器根据 MIT License 发布。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT License 的条款和条件。有关详细信息，请参阅项目仓库中的 LICENSE 文件。