使用说明内容（Markdown格式）

Linear MCP 服务器使用指南

• 项目简介

  • 这是一个基于 MCP 框架的后端服务器实现，专门通过 Dedalus 的 MCP 生态暴露 Linear 的数据工具集给 LLM 客户端使用，允许通过标准化接口读取数据、执行外部工具、以及进行资源管理等。

• 主要功能点

  • 将 Linear 的图形化 API 封装为 MCP 工具，供 LLM 调用
  • 支持通过令牌认证机制获取 Linear API 的访问权限
  • 通过 MCP 服务器实例化并监听指定端口，提供 JSON-RPC 风格的请求/响应
  • 兼容多种传输方式（默认基于 HTTP/2 流式传输能力，实际实现依赖 MCP 框架）

• 安装步骤

  • 准备 Python 环境（推荐使用虚拟环境）
  • 安装所需依赖库（如 dedalus_mcp 等 MCP 框架相关依赖；具体依赖请参考项目的依赖管理）
  • 将仓库代码放置在本地目录，确保 Python 能够找到入口脚本
  • 配置环境变量（如 DEDALUS_AS_URL，用于授权服务器地址）
  • 启动服务器：在项目根目录执行 python main.py

• 服务器配置 MCP 客户端需要一个配置来知道如何启动和连接到该服务器。以下为示例配置信息（JSON 格式，包含 server、command、args 等字段；请按实际部署环境填写）。注：下面给出的是可用于客户端信息理解的字段描述，实际客户端无需直接执行该配置代码。

  { "server": "linear-mcp", "command": "python", "args": ["main.py"], "port": 8080 }

  说明：

  • server: MCP 服务器的唯一名称，需与实际部署的一致
  • command: 启动服务器的命令（不涉及客户端逻辑）
  • args: 启动命令的参数，确保入口脚本为 main.py
  • port: 服务器监听端口，默认 8080

• 基本使用方法

  • 启动后，LLM 客户端通过 MCP 客户端来向服务器发送 JSON-RPC 请求，调用 Linear 的工具集（如获取用户、列出问题、创建问题等）以获取所需上下文数据或执行外部功能
  • 客户端需通过授权服务器进行 OAuth2 令牌交换，以便 Linear API 的访问权限
  • 客户端应遵循 MCP 的传输协议与会话管理规范，确保在对话会话中维持上下文与能力声明