MCP 서버 해제
Unleash Feature Toggle 시스템과 통합되는 MCP(Model Context Protocol) 서버 구현입니다.
개요
이 프로젝트는 모델 컨텍스트 프로토콜(MCP)을 사용하여 LLM 애플리케이션과 Unleash 피처 플래그 시스템을 연결합니다. 이를 통해 AI 애플리케이션은 다음과 같은 작업을 수행할 수 있습니다.
- Unleash에서 기능 플래그 상태 확인
- LLM에 기능 플래그 정보 공개
- 기능 플래그 생성
- 기능 플래그 업데이트
- 모든 프로젝트 나열
목차
요구 사항
- Node.js(v18 이상)
- TypeScript(v5.0 이상)
- Unleash 서버 인스턴스에 액세스
설치
지엑스피1
건축학
Unleash MCP 서버는 LLM 애플리케이션과 Unleash 기능 플래그 시스템 간의 브리지 역할을 합니다.
+----------------+ +-------------------+ +----------------+
| | | | | |
| LLM App | <--> | Unleash MCP | <--> | Unleash API |
| (MCP Client) | | Server | | Server |
| | | | | |
+----------------+ +-------------------+ +----------------+
개발
프로젝트 구조
unleash-mcp-server/
├── src/
│ ├── index.ts # Main entry point
│ ├── server.ts # Server implementation
│ ├── config.ts # Configuration handling
│ ├── transport/ # MCP transport implementations
│ │ ├── http.ts # HTTP/SSE transport
│ │ └── stdio.ts # STDIO transport
│ ├── unleash/ # Unleash API client implementations
│ │ ├── unleash-client.ts # Main Unleash client
│ │ ├── get-feature-flag.ts
│ │ └── get-all-projects.ts
│ ├── resources/ # MCP resource implementations
│ │ ├── flags.ts # Feature flag resources
│ │ └── projects.ts # Project resources
│ ├── tools/ # MCP tool implementations
│ │ ├── get-flag.ts # Get feature flag tool
│ │ └── get-projects.ts # Get projects tool
│ └── prompts/ # MCP prompt implementations
│ ├── flag-check.ts # Check single flag
│ └── batch-flag-check.ts # Check multiple flags
├── tests/ # Tests
└── package.json # Project configuration
코딩 표준
- 명명 규칙 :
- 파일: kebab-case.ts를 사용하세요(예:
feature-flag.ts ) - 클래스: PascalCase를 사용하세요(예:
UnleashClient ) - 함수/메서드: camelCase를 사용하세요(예:
getFlagStatus ) - 인터페이스/유형: PascalCase를 사용하세요(예:
FeatureFlagConfig )
- 수입품 :
- 로컬 파일을 가져올 때는 항상 .js 확장자를 포함하세요.
- 가져오기 순서를 따르세요: Node.js 내장 → 외부 종속성 → 로컬 가져오기
- 기본 내보내기 대신 명명된 내보내기를 사용하세요
- 문서 :
- 공개 함수, 클래스 및 인터페이스에 JSDoc 주석을 사용하세요
- 인라인 주석으로 복잡한 논리를 문서화하세요
건물
# Compile TypeScript
npm run build
# Run the server
npm start
테스트
검사 중
# MCP stdio inspect
npm run build
npx @modelcontextprotocol/inspector node dist/index.js
# MCP sse inspect
npm start
npx @modelcontextprotocol/inspector
사용 방법
Claude 또는 Cursor 구성의 경우:
{
"mcpServers": {
"unleash": {
"command": "npx",
"args": [
"-y",
"unleash-mcp"
],
"env": {
"UNLEASH_URL": "YOUR_UNLEASH_END_POINT",
"UNLEASH_API_TOKEN": "YOUR_UNLEASH_API_TOKEN",
"MCP_TRANSPORT": "stdio",
"MCP_HTTP_PORT": 3001
}
}
}
}
기여하다
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.
프로젝트 지원하기
만약 이 프로젝트가 도움이 된다면, 저에게 커피 한 잔 사주세요!
위의 QR 코드를 스캔하거나 여기를 클릭하여 이 프로젝트 개발을 지원해주세요.
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.