MCP 통합 워크스페이스 구축 실전

filesystem·GitHub·memory 복수 서버 연계와 운용자동화

2부 MPC 부분을 집대성하는 단계로 2부 1장(8회~15회)의 집대성으로서, 8회~15회에서 배운 지식을 사용하여 새로운 디렉토리(~/mcp-integrated)에 filesystem MCP, GitHub MCP, memory MCP를 통합한 워크스페이스를 제로부터 구축합니다. 설계부터 구축, 테스트, 운용 시작까지의 전 공정을 실시합니다.

왜 새로운 디렉토리에서 구축하는가

8회~15회에서는 ~/mcp-workspace에서 학습을 진행해왔지만, 연습용 설정 파일(mcp-servers.json, mcp-with-env.json 등)이 다수 남아 있습니다. 이것들과 통합 환경의 파일이 혼재하면 관리하기 어려워지므로, 클린한 상태에서 실운용을 상정한 워크스페이스를 새로 구축합니다.

배경 지식

통합의 전체 구조

8회~15회에서 배운 지식을 총동원하여 통합 워크스페이스를 구축합니다.

통합 워크스페이스 (완성형)

통합의 장점

단일 MCP 서버로는 할 수 없는 것이, 복수의 조합으로 가능해집니다.

� 한국 팀 개발에서의 응용 시나리오
- Jira Issue → 코드 스캐폴딩: Jira MCP(Issue 읽기) + filesystem MCP(파일 생성) + GitHub MCP(브랜치·PR 작성)
- 코드 리뷰 자동화: GitHub MCP(PR diff 취득) + filesystem MCP(로컬 규약 파일 참조) + memory MCP(리뷰 컨텍스트 보존)

따라하기

1단계: 프로젝트 신규 작성

통합 워크스페이스용 디렉토리를 새로 작성합니다.

mkdir -p ~/mcp-integrated
cd ~/mcp-integrated
git init
git branch -M main
echo "# MCP 통합 워크스페이스" > README.md
git add README.md
git commit -m "Initial commit"

디렉토리 구성을 정돈합니다.

mkdir -p src docs config scripts

완성 시의 프로젝트 구조:

~/mcp-integrated/
├── .env ← 인증 정보 (Git 관리 밖) ⚠️
├── .gitignore ← 제외 설정
├── README.md
├── config/
│ ├── mcp-base.json ← 기본 MCP 서버 설정 (Git 관리 OK)
│ ├── mcp-dev.json ← 개발 툴 설정 (Git 관리 OK)
│ ├── mcp-all.json ← 통합 설정 (Git 관리 밖) ⚠️
│ └── mcp-github.json.template ← 템플릿 (Git 관리 OK)
├── scripts/
│ └── start-workspace.sh ← 기동 스크립트 (Git 관리 OK)
├── src/
└── docs/

2단계: 인증 정보의 셋업

11회에서 배운 방법으로 .env 파일에 GitHub PAT를 저장하고, 15회에서 배운 퍼미션 제한도 적용합니다.

# GitHub CLI로 현재 토큰을 확인
gh auth token

취득한 토큰을 .env 파일에 저장합니다.

cat > ~/mcp-integrated/.env << 'EOF'
GITHUB_PERSONAL_ACCESS_TOKEN=<gh auth token으로 취득한 토큰>
EOF

chmod 600 ~/mcp-integrated/.env

⚠️ 중요: .env에는 인증 정보가 포함됩니다. 4단계에서 .gitignore를 설정할 때까지, 절대로 git add나 git commit을 하지 마세요.

3단계: MCP 설정 파일의 작성

10회에서 배운 용도별 설정 파일 분할을 적용합니다.

기본 툴 설정 (filesystem만 - Git 관리 OK):

cat > ~/mcp-integrated/config/mcp-base.json << 'EOF'
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "~/mcp-integrated"]
}
}
}
EOF

개발 툴 설정 (memory - Git 관리 OK):

cat > ~/mcp-integrated/config/mcp-dev.json << 'EOF'
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"]
}
}
}
EOF