remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides tools for searching, reading, updating, and commenting on issues in Linear's issue tracking system.

선형 MCP 서버

선형 통합을 위한 MCP 서버의 Node.js 구현입니다.

에 대한

이 MCP(Model Context Protocol) 서버는 AI 모델이 선형 문제 추적 기능과 상호 작용할 수 있는 표준화된 인터페이스를 제공합니다.

주요 특징

공식 MCP SDK를 사용한 Linear용 표준 MCP 프로토콜 구현
문제 검색, 세부 정보 읽기, 업데이트 및 의견 달기 지원

시작하기

필수 조건

Node.js (v18 이상)
선형 API 키

설치

저장소를 복제합니다
종속성 설치

지엑스피1

Linear API 키로 루트 디렉토리에 .env 파일을 만듭니다.

LINEAR_API_KEY=your_linear_api_key_here

서버 실행

서버를 시작합니다:

npm start

파일 감시를 통한 개발의 경우:

just dev

디버그 로깅을 통한 개발의 경우:

just debug

또는 환경 변수를 수동으로 설정하세요.

LOG_LEVEL=DEBUG NODE_ENV=development node src/index.js

STDIO 전송을 방해하지 않기 위해 로그는 logs/mcp-linear.log 파일에 기록됩니다.

MCP Inspector와 함께 사용

서버는 stdio 모드에서 실행되므로 MCP Inspector를 사용하여 서버에 연결할 수 있습니다.

한 터미널에서 서버를 시작합니다.

npm start

https://inspector.modelcontextprotocol.ai 에서 웹 기반 검사기를 방문하세요.
전송 유형으로 "stdio"를 선택하세요
다음 명령을 입력하세요:

node /path/to/mcp-linear/src/index.js

실행 중인 서버에 연결하려면 "연결"을 클릭하세요.

Claude Desktop과 함께 사용

Claude Desktop 구성 파일(일반적으로 ~/.config/Claude Desktop/claude_desktop_config.json )에 다음을 추가합니다.

{
  "mcp": {
    "servers": [
      {
        "name": "Linear",
        "command": "node /path/to/mcp-linear/src/index.js",
        "env": {
          "LINEAR_API_KEY": "your_linear_api_key_here"
        }
      }
    ]
  }
}

커서를 사용한 사용

커서의 경우 설정에 다음을 추가하세요.

{
  "ai.mcp.servers": [
    {
      "name": "Linear",
      "command": "node /path/to/mcp-linear/src/index.js",
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  ]
}

통합 테스트

설정을 확인하려면:

Claude Desktop 또는 Cursor 설정에서 MCP 서버를 구성하세요.
애플리케이션을 다시 시작하세요
질문: "버그"를 포함하는 선형 문제를 검색하세요.
보조자는 Linear MCP 서버를 감지하고 이를 사용하여 결과를 검색해야 합니다.

프로젝트 구조

/
├── src/                     # Source code
│   ├── effects/             # Effects implementation
│   │   ├── linear/          # Linear API effects
│   │   │   └── types/       # Linear type definitions
│   │   └── logging/         # Logging effects for safe logging with STDIO
│   ├── tools/               # MCP tools implementation
│   │   ├── types/           # Tool type definitions
│   │   └── utils/           # Tool utility functions
│   ├── utils/               # Utility modules
│   │   └── config/          # Configuration utilities
│   └── index.js             # Main entry point
├── docs/                    # Documentation
│   └── llm_context/         # Documentation for LLMs
├── logs/                    # Log files (created at runtime)
└── package.json             # Project configuration

사용 가능한 도구

MCP 서버는 다음 도구를 제공합니다.

list_issues - 다양한 필터링 옵션(담당자, 상태 등)을 사용하여 선형 문제(티켓이라고도 함)를 나열합니다.
get_issue - ID로 특정 선형 문제에 대한 자세한 정보를 가져옵니다.
list_members - 이름별 필터링을 통해 선형 팀 구성원 목록 표시
list_projects - 팀, 이름 및 보관 상태별 선택적 필터링을 통해 선형 프로젝트 나열
get_project - 이슈, 멤버 등을 포함한 특정 Linear 프로젝트에 대한 자세한 정보를 가져옵니다.
list_teams - 멤버, 프로젝트 및 문제에 대한 세부 정보가 포함된 선형 팀 목록
add_comment - 특정 Linear 문제에 대한 주석을 추가합니다.
create_issue - 사용자 정의 가능한 제목, 설명, 우선순위 및 담당자를 사용하여 Linear에서 새 이슈를 만듭니다.

이전 버전과의 호환성을 위해 다음 도구 별칭도 사용할 수 있습니다.

list_tickets - list_issues 의 별칭
get_ticket - get_issue 의 별칭

문제 해결

Linear MCP 서버에 문제가 있는 경우:

Linear API 키 확인 : .env 파일이나 환경 변수에 유효한 Linear API 키를 설정했는지 확인하세요. Linear API 키는 "lin api "로 시작해야 합니다.
디버그 로깅 활성화 :a. MCP 서버를 시작할 때:
just debug # or LOG_LEVEL=DEBUG NODE_ENV=development node src/index.js
b. 클라이언트 구성(Claude Desktop, Cursor 등)에서 다음을 수행하세요.
"env": { "LINEAR_API_KEY": "your_linear_api_key_here", "LOG_LEVEL": "DEBUG" }
c. 도구를 직접 호출할 때 debug 매개변수를 추가합니다.
{ "debug": true }
로그 파일 확인 : 자세한 오류 정보를 확인하려면 logs/mcp-linear.log 파일의 로그를 살펴보세요.
Linear API 액세스 확인 : Linear API 키에 적절한 권한이 있는지 확인하고 Linear API에 직접 액세스할 수 있는지 확인하세요.

건축학

이 애플리케이션은 효과 기반 아키텍처를 따릅니다.

효과 : 부작용이 있는 작업은 effects 디렉토리에 격리됩니다.
- linear : 공식 Linear SDK를 사용하여 Linear API에 대한 액세스를 제공합니다.
- logging : STDIO 전송을 방해하지 않는 안전한 로깅
도구 : 부작용에 대한 효과를 사용하는 MCP 도구 구현:
- 각 도구는 Zod를 사용한 입력 검증을 통해 일관된 패턴을 따릅니다.
- 도구는 서버를 통해 MCP 프로토콜을 통해 노출됩니다.
- 각 도구는 선형 효과를 통해 선형 클라이언트에 액세스할 수 있습니다.
유틸리티 : 구성 및 공통 기능을 위한 유틸리티 모듈

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

AI 모델이 선형 문제 추적 기능과 상호 작용하여 문제 검색, 세부 정보 읽기, 업데이트 및 의견 달기를 지원할 수 있는 Deno 구현입니다.

Appeared in Searches

A Windows COM server for automating Windows tasks