선형 MCP 서버

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

에 대한

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

주요 특징

• 공식 MCP SDK를 사용한 Linear용 표준 MCP 프로토콜 구현

• 문제 검색, 세부 정보 읽기, 업데이트 및 의견 달기 지원

Related MCP server: Linear MCP Server

시작하기

필수 조건

• Node.js (v18 이상)

• 선형 API 키

설치

1. 저장소를 복제합니다

2. 종속성 설치

지엑스피1

3. 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를 사용하여 서버에 연결할 수 있습니다.

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

npm start

2. https://inspector.modelcontextprotocol.ai 에서 웹 기반 검사기를 방문하세요.

3. 전송 유형으로 "stdio"를 선택하세요

4. 다음 명령을 입력하세요:

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

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

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"
      }
    }
  ]
}

통합 테스트

설정을 확인하려면:

1. Claude Desktop 또는 Cursor 설정에서 MCP 서버를 구성하세요.

2. 애플리케이션을 다시 시작하세요

3. 질문: "버그"를 포함하는 선형 문제를 검색하세요.

4. 보조자는 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 서버에 문제가 있는 경우:

1. Linear API 키 확인 : .env 파일이나 환경 변수에 유효한 Linear API 키를 설정했는지 확인하세요. Linear API 키는 "lin api "로 시작해야 합니다.

2. 디버그 로깅 활성화 :

   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
   }

3. 로그 파일 확인 : 자세한 오류 정보를 확인하려면 logs/mcp-linear.log 파일의 로그를 살펴보세요.

4. Linear API 액세스 확인 : Linear API 키에 적절한 권한이 있는지 확인하고 Linear API에 직접 액세스할 수 있는지 확인하세요.

건축학

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

• 효과 : 부작용이 있는 작업은 effects 디렉토리에 격리됩니다.

  • linear : 공식 Linear SDK를 사용하여 Linear API에 대한 액세스를 제공합니다.

  • logging : STDIO 전송을 방해하지 않는 안전한 로깅

• 도구 : 부작용에 대한 효과를 사용하는 MCP 도구 구현:

  • 각 도구는 Zod를 사용한 입력 검증을 통해 일관된 패턴을 따릅니다.

  • 도구는 서버를 통해 MCP 프로토콜을 통해 노출됩니다.

  • 각 도구는 선형 효과를 통해 선형 클라이언트에 액세스할 수 있습니다.

• 유틸리티 : 구성 및 공통 기능을 위한 유틸리티 모듈

기여하다

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

특허

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