uml-mcp-server

urstory/uml-mcp-server

3.2

If you are the rightful owner of uml-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The UML MCP Server is designed to generate PlantUML diagrams for Claude Desktop, supporting various output formats and seamless integration.

Tools
2
Resources
0
Prompts
0

UML MCP Server

Claude Desktop용 PlantUML 다이어그램 생성 MCP 서버입니다.

기능

  • PlantUML 다이어그램을 텍스트로 생성
  • PNG, SVG, PDF 형식 지원
  • Claude Desktop과 원활한 통합

사전 요구사항

  • Node.js 18 이상
  • Java (PlantUML 실행용)
  • Python 3 (create-uml 스크립트용)
  • PlantUML JAR 파일

설치

1. 저장소 클론

git clone https://github.com/yourusername/uml-mcp-server.git
cd uml-mcp-server

2. 의존성 설치

npm install

3. PlantUML 및 헬퍼 스크립트 설치

이 MCP 서버는 ~/.local/bin/create-uml 스크립트가 필요합니다.

# 디렉토리 생성
mkdir -p ~/.local/bin/uml-tools

# PlantUML JAR 다운로드
curl -L https://github.com/plantuml/plantuml/releases/download/v1.2024.7/plantuml-1.2024.7.jar \
  -o ~/.local/bin/uml-tools/plantuml.jar

# Python 헬퍼 스크립트 생성 (아래 create_uml.py 참조)
# Bash 스크립트 생성 (아래 generate-uml.sh 참조)

# 심볼릭 링크 생성
ln -s ~/.local/bin/uml-tools/create_uml.py ~/.local/bin/create-uml
ln -s ~/.local/bin/uml-tools/generate-uml.sh ~/.local/bin/generate-uml

# 실행 권한 부여
chmod +x ~/.local/bin/uml-tools/*.py
chmod +x ~/.local/bin/uml-tools/*.sh

4. Claude Desktop 설정

~/Library/Application Support/Claude/claude_desktop_config.json 파일에 다음을 추가합니다:

{
  "mcpServers": {
    "uml-generator": {
      "command": "node",
      "args": ["/path/to/uml-mcp-server/index.js"]
    }
  }
}

주의: /path/to/uml-mcp-server를 실제 설치 경로로 변경하세요.

5. Claude Desktop 재시작

설정 파일을 수정한 후 Claude Desktop을 완전히 종료하고 다시 시작합니다.

사용 방법

Claude Desktop에서 다음과 같이 요청할 수 있습니다:

사용자: 로그인 시퀀스 다이어그램을 만들어줘

Claude: [create_uml_diagram 도구 사용]

지원하는 다이어그램 타입

  • 시퀀스 다이어그램 (Sequence Diagram)
  • 클래스 다이어그램 (Class Diagram)
  • 유즈케이스 다이어그램 (Use Case Diagram)
  • 활동 다이어그램 (Activity Diagram)
  • 컴포넌트 다이어그램 (Component Diagram)
  • 상태 다이어그램 (State Diagram)
  • 객체 다이어그램 (Object Diagram)
  • 배포 다이어그램 (Deployment Diagram)
  • 타이밍 다이어그램 (Timing Diagram)

제공하는 도구

1. create_uml_diagram

PlantUML 콘텐츠로부터 다이어그램을 생성합니다.

파라미터:

  • content (string, 필수): PlantUML 다이어그램 내용
  • output_path (string, 필수): 출력 파일 경로 (확장자 제외)
  • format (string, 선택): 출력 형식 (png, svg, pdf, 기본값: png)

2. generate_uml_from_file

기존 .puml 파일로부터 이미지를 생성합니다.

파라미터:

  • puml_file (string, 필수): .puml 파일 경로
  • format (string, 선택): 출력 형식 (png, svg, pdf, 기본값: png)

문제 해결

"create-uml: command not found" 오류

~/.local/bin이 PATH에 있는지 확인하세요:

echo $PATH | grep ".local/bin"

없다면 ~/.zshrc 또는 ~/.bashrc에 추가:

export PATH="$HOME/.local/bin:$PATH"

"Java가 설치되지 않음" 오류

# macOS
brew install openjdk

# Ubuntu/Debian
sudo apt-get install default-jdk

# Verify
java -version

MCP 서버가 연결되지 않음

  1. Claude Desktop 로그 확인:
tail -f ~/Library/Logs/Claude/mcp-server-uml-generator.log
  1. 설정 파일 경로가 올바른지 확인
  2. Node.js가 설치되어 있는지 확인

라이선스

MIT License

기여

이슈와 Pull Request를 환영합니다!

관련 링크