MCP线性应用程序
模型上下文协议（MCP），用于与Linear集成作为人工智能工具。该工具允许您的AI通过模型上下文协议与Linear进行交互。
特性
- 完全线性积分:
- 搜索问题 - 创建新问题 - 更新问题 - 添加评论 - 更新评论 - 获取用户资料 - 获取团队信息
先决条件
- Node.js 18或更新版本
- 线性API键
如何获取线性API密钥
若要使用此应用程序，您需要一个Linear API键。以下是获得一个的步骤：
- 登录或创建线性帐户
- 访问 线性 登录您现有的帐户或注册以创建新帐户
- 访问工作区设置
- 在主页上，单击左上角的用户名 - 选择“工作区设置”选项
- 打开API设置
- 在左侧的“设置”列中，向下滚动直到找到“API” - 点击“API”选项
- 创建新的API密钥
- 为API键输入标签（例如“MCP线性应用程序”） - 单击“新建API密钥”按钮
- 安全存储API密钥
- API键将只显示一次 - 复制并保存到安全位置，因为Linear不会再次显示它
重要提示：Linear对API密钥的请求速率限制为每小时1500次。确保您的应用程序遵循此限制，以避免429 Too Many Requests错误。
有关获取和使用Linear API密钥的更多详细信息，您可以访问 Merge.dev上的指南.
如何使用该工具
1.初始设置
- 克隆此存储库：
git clone git@github.com:zalab-inc/mcp-linear-app.git
cd mcp-linear-app- 安装依赖项：
npm install- 创建一个
.env根目录中的文件：
LINEAR_API_KEY=your_linear_api_key_here- 构建项目：
npm run build- 这
dist文件夹现在已准备好用于各种AI平台中的配置。
2.光标配置
- 查找您的Cursor MCP配置文件：
- 窗户： C:\Users\\.cursor\mcp.json - macOS： ~/.cursor/mcp.json - Linux： ~/.cursor/mcp.json
- 编辑文件以添加Linear MCP服务器配置：
{
"mcpServers": {
"linear": {
"command": "
",
"args": [
"
/dist/index.js"
],
"env": {
"LINEAR_API_KEY": "your_linear_api_key_here"
}
}
}
}- 替换占位符：
- ：Node.js可执行文件的路径 - ：MCP线性应用程序项目目录的绝对路径 - your_linear_api_key_here：您的线性API键
配置示例：
{
"mcpServers": {
"linear": {
"command": "C:\\nvm4w\\nodejs\\node.exe",
"args": [
"H:\\mcp\\linear\\dist\\index.js"
],
"env": {
"LINEAR_API_KEY": "lin_api_xxxxxxxxxxxxxxxxxxxxx"
}
}
}
}- 保存文件并重新启动Cursor以使更改生效。
3.克劳德配置
要将MCP线性工具与Claude一起使用，您需要将配置添加到Claude的设置文件中。请按照以下步骤操作：
- 打开Claude AI桌面应用程序设置
- 导航到“开发人员”部分
- 查找“工具”配置部分
- 添加线性MCP的配置如下：
{
"tools": {
"linear": {
"command": "
",
"args": [
"
/dist/index.js"
],
"env": {
"LINEAR_API_KEY": "your_linear_api_key_here"
}
}
}
}- 替换占位符：
- ：Node.js可执行文件的路径 - ：MCP线性应用程序项目目录的绝对路径 - your_linear_api_key_here：您的线性API键
配置示例：
{
"tools": {
"linear": {
"command": "/usr/local/bin/node",
"args": [
"/Users/username/projects/mcp-linear-app/dist/index.js"
],
"env": {
"LINEAR_API_KEY": "lin_api_xxxxxxxxxxxxxxxxxxxxx"
}
}
}
}4.其他平台上的配置
基本原理与支持MCP的其他AI平台相同：
- 查找外部工具或MCP的配置区域
- 配置它以运行Node.js
dist/index.js此存储库中的文件 - 在环境配置中包含LINEAR_API_KEY
可用工具
配置后，您的AI将可以访问以下线性工具：
search_issues-按关键字、状态或优先级搜索问题create_issue-创建新问题get_issue-获取问题详细信息update_issue-更新现有问题create_comment-向问题添加评论get_comment-从问题中获取评论update_comment-更新或删除评论get_profile-获取当前Linear用户配置文件get_team_id-获取团队及其ID列表
支持和帮助
如果您在使用此工具时遇到问题，请：
- 请检查您的Linear API密钥是否有效并具有足够的权限
- 确保Node.js安装正确
- 检查AI平台中的MCP配置
- 检查日志文件中可能出现的任何错误消息
在AI环境中使用线性工具
一旦你在人工智能环境中配置了线性工具，你就可以通过提示人工智能来开始使用它们。以下是一些示例：
在游标中使用线性工具
在Cursor中，您可以简单地让Claude执行与线性相关的任务：
Search for high priority issues in our Linear project.Create a new issue in Linear with the title "Improve login page performance" and add it to the backlog.Get the details of the issue LIN-123 from Linear.Add a comment to issue LIN-456 saying "This is fixed in the latest release. Please verify."Update the priority of issue LIN-789 to urgent.示例工作流：创建和管理问题
以下是一个示例工作流，显示了如何使用这些工具：
- 查找您的团队ID:
What's my Linear team ID?克劳德将使用 get_team_id 获取团队信息的工具。
- 创建新问题:
Create a new Linear issue titled "Implement password reset feature" for the Engineering team with a high priority. The description should be "Users need a way to reset their passwords when they forget them."克劳德将使用 create_issue 工具具有必要的参数。
- 搜索问题:
Find all high priority issues assigned to me that are currently in progress.克劳德将使用 search_issues 带有适当过滤器的工具。
- 更新问题:
Update issue LIN-456 to add the description "This issue has been verified and tested on all browsers."克劳德将使用 update_issue 工具来修改问题。
- 添加评论:
Add a comment to issue LIN-789 asking "Is this still a priority for this sprint?"克劳德将使用 create_comment 添加评论的工具。
- 正在检索评论:
Show me all the comments on issue LIN-321克劳德将使用 get_comment 获取评论的工具。
这些示例展示了一旦工具配置正确，您可以通过人工智能助手与Linear进行自然交互。
最近的更新
该项目最近通过改进文档和线性工具功能得到了增强。这些改进包括：
- 更新了README，提供了更清晰的安装和配置说明
- 通过各种AI平台的示例增强文档
- 改进的线性工具具有更好的错误处理和响应格式
- 添加了对管理评论（创建、获取、更新、删除）的支持
- 通过按状态和优先级过滤改进了搜索能力
许可证
该项目根据MIT许可证获得许可。
https://kelasinovatif.com/