-
security-
license-
qualityEnables AI models to interact with Linear for issue tracking and project management through capabilities like creating/searching issues, managing sprints, and retrieving workflow states.
Last updated -
선형 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.jsb. 클라이언트 구성(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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
Related MCP Servers
- Asecurity-licenseAqualityA Model Context Protocol server that integrates with Linear, enabling AI assistants to create, update, search, and comment on issues for project management and issue tracking.Last updated -6Apache 2.0
- -security-license-qualityAllows LLMs to integrate with Linear's issue tracking system, enabling them to create, update, search, and comment on issues through the Linear API.Last updated -236
- -security-license-qualityProvides access to Linear's issue tracking system through a standardized Model Context Protocol interface, allowing users to create, update, search, and manage issues, projects, and comments via natural language.Last updated -1,4541MIT License