项目简介
'Tiger Linear MCP Server' 是一个基于 Model Context Protocol (MCP) 构建的服务端应用。它将流行的项目管理工具 Linear 的 API 封装成易于 LLM(大型语言模型)调用的标准化工具,允许 LLM 客户端通过 MCP 协议与 Linear 进行交互,获取项目、问题、用户等信息。
主要功能点
- 获取用户列表: LLM 可以查询 Linear 组织内的所有用户,并支持通过关键词进行过滤,以便找到特定用户。
- 获取项目列表: LLM 可以查询 Linear 组织内的所有项目,并支持通过关键词进行过滤,以定位到相关项目。
- 获取单个问题详情: LLM 可以根据 Linear 问题的唯一标识符(如 'ABC-123')获取其详细信息,包括指派人、创建者、描述、评论、附件、所属项目、状态等。
- 获取问题列表: LLM 可以根据指派用户ID、项目ID以及更新时间范围(默认为最近7天)过滤并获取 Linear 问题列表。
安装步骤
- 克隆仓库:
git clone [email protected]:timescale/tiger-linear-mcp-server.git cd tiger-linear-mcp-server - 安装依赖并构建:
npm install - 配置 Linear API Key:
- 复制 '.env.sample' 文件并命名为 '.env'。
cp .env.sample .env- 编辑 '.env' 文件,将 'LINEAR_API_KEY' 替换为您的 Linear API 密钥。例如:
LINEAR_API_KEY=lin_api_您的API密钥
服务器配置 (供MCP客户端使用)
MCP 客户端(例如 Claude Desktop)需要配置本 MCP 服务器的启动信息才能建立连接。以下是一个配置示例,请根据您的实际环境调整路径:
{ "mcpServers": { "tiger-linear": { "command": "node", "args": [ "/absolute/path/to/tiger-linear-mcp-server/dist/index.js", // 替换为您的 tiger-linear-mcp-server 项目的绝对路径 "stdio" ], "env": { "LINEAR_API_KEY": "lin_api_您的API密钥" // 替换为您的 Linear API 密钥 } } } }
说明:
- '"tiger-linear"': 服务器的名称。
- '"command": "node"': 启动服务器使用的命令。
- '"args"': 启动命令的参数列表。
- 第一个参数是服务器主程序的绝对路径,务必将其替换为您本地克隆的 'tiger-linear-mcp-server' 仓库的 'dist/index.js' 文件的完整路径。
- 第二个参数 '"stdio"' 表示使用标准输入输出 (Stdio) 作为通信协议。
- '"env"': 服务器运行所需的环境变量。请务必在此处提供您的 'LINEAR_API_KEY'。
基本使用方法
配置完成后,您的 MCP 客户端即可连接到 'Tiger Linear MCP Server'。LLM 将能够通过调用本服务器提供的工具(如 'get_issues', 'get_users' 等)来查询和获取 Linear 中的数据。例如,LLM 可以请求 "查询最近七天内分配给我的所有 Linear 问题" 或 "查找名为 'John Doe' 的用户 ID"。
信息
分类
开发者工具