Linear MCP Server

🚀 Linear MCP Server

The Linear MCP Server is a high - performance server that integrates Linear's official SDK and MCP protocol, providing type - safe and efficient services.

🚀 Quick Start

To quickly get started with the Linear MCP Server, you can refer to the following code example:

import { type Context } from '@modelcontextprotocol/sdk'

export async function getContext(): Promise<Context> {
  const config = new Configuration()
  const client = new LinearClient(config)
  return await client.getContext()
}

✨ Features

• Type Safety: All interfaces and methods are defined using TypeScript, ensuring the type safety of the code.
• High Performance: Built on the Bun runtime environment, it offers excellent execution efficiency.
• Integrated SDK: Integrates Linear's official SDK and MCP Protocol version 1.4.0.

📦 Installation

Install Dependencies

To use this project, make sure you have installed the following dependencies:

bun add @linear/sdk @modelcontextprotocol/sdk

Start the Server

Before starting the server, configure the environment variable NEXT_PUBLIC_LINEAR_SDK_CONFIG:

{
  "url": "https://app.linear.app",
  "authType": "token"
}

Then run:

bun dev

📚 Documentation

Configuration Parameters

Environment Variables

• NEXT_PUBLIC_BASE_URL: Set it to your Linear base URL, the default is https://app.linear.app.
• NEXT_PUBLIC_WEB_BASE_URL: Set it to the public URL of your web application.

Other Configurations

Add the following content to the .env file:

NEXT_PUBLIC_LINEAR_SDK_CONFIG=url=https://app.linear.app&authType=token

Advanced Features

Team Management

• Get all teams: GET /api/teams
• Search for specific teams: Supports filtering by name or key.

Project Operations

• List all projects: GET /api/projects
• Create a new project: POST /api/projects

🔧 Technical Details

Architectural Components

• Front - end Interface: Implements a responsive design using React and Tailwind CSS.
• Back - end Logic: Builds an efficient server architecture based on Bun.

Data Processing Flow

1. Request reception and parsing
2. Parameter validation
3. Business logic execution
4. Result packaging and return

🚫 Error Handling Mechanism

Exception Capture

• Network error detection
• HTTP status code handling
• Detailed error log recording

Global Middleware

Used to uniformly handle all API requests and responses, ensuring system stability.

📄 License

This project is licensed under the MIT License. For more details, please refer to the LICENSE file.