MCP 생태계

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Documents",
        "/Users/username/Projects"
      ]
    }
  }
}

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://user:pass@localhost/mydb"
      ]
    }
  }
}

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

# Smithery CLI 설치
npm install -g @smithery/cli

# 서버 검색
smithery search github

# 서버 정보 조회
smithery info @modelcontextprotocol/server-github

# Claude Desktop에 서버 추가
smithery install @modelcontextprotocol/server-github

# 설치된 서버 목록
smithery list

# 서버 업데이트
smithery update @modelcontextprotocol/server-github

{
  "name": "my-awesome-server",
  "version": "1.0.0",
  "description": "간단한 설명",
  "author": "Your Name",
  "license": "MIT",
  "keywords": ["mcp", "server", "api"],
  "category": "web-api",
  "repository": "https://github.com/username/my-awesome-server",
  "homepage": "https://github.com/username/my-awesome-server#readme",
  "command": "node",
  "args": ["dist/index.js"],
  "env": {
    "API_KEY": {
      "description": "Your API key",
      "required": true
    }
  }
}

# Smithery에 로그인
smithery login

# 서버 게시
smithery publish

# 새 버전 게시
smithery publish --version 1.0.1

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Documents",
        "/Users/username/Projects",
        "/Users/username/Downloads"
      ]
    }
  }
}

// 사용자
"Documents 폴더에서 .md 파일을 찾아줘"

// Claude (MCP 파일시스템 서버 사용)
1. search_files 도구 호출:
   directory: /Users/username/Documents
   pattern: **/*.md

2. 결과:
   - README.md
   - notes/meeting-2024-01.md
   - docs/api-reference.md

// 사용자
"README.md의 내용을 읽어줘"

// Claude
1. read_file 도구 호출:
   path: /Users/username/Documents/README.md

2. 파일 내용 표시...

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

// 사용자
"내 리포지토리 중에서 'bug' 레이블이 있는 open 이슈를 찾아줘"

// Claude
1. 리포지토리 목록 조회
2. 각 리포지토리에서 list_issues 호출
3. 결과 집계 및 표시

발견된 이슈:
- repo1: #42 "Memory leak in parser" (bug, high-priority)
- repo2: #15 "Crash on startup" (bug)
- repo3: #8 "Invalid input handling" (bug, needs-triage)

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://user:password@localhost:5432/mydb"
      ]
    }
  }
}

// 사용자
"users 테이블의 스키마를 보여줘"

// Claude
테이블: users
컬럼:
- id (integer, PRIMARY KEY)
- email (varchar(255), UNIQUE, NOT NULL)
- name (varchar(100))
- created_at (timestamp, DEFAULT now())
- is_active (boolean, DEFAULT true)

인덱스:
- users_pkey (PRIMARY KEY on id)
- users_email_idx (UNIQUE on email)

// 사용자
"지난 7일간 가입한 활성 사용자 수를 알려줘"

// Claude
SELECT COUNT(*) as active_users
FROM users
WHERE created_at >= NOW() - INTERVAL '7 days'
  AND is_active = true;

결과: 127명

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your_api_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-token",
        "SLACK_TEAM_ID": "T1234567"
      }
    }
  }
}

# 1. 저장소 포크
gh repo fork modelcontextprotocol/servers

# 2. 브랜치 생성
git checkout -b feature/my-new-server

# 3. 변경사항 커밋
git add .
git commit -m "Add new server for XYZ service"

# 4. 푸시
git push origin feature/my-new-server

# 5. Pull Request 생성
gh pr create --title "Add XYZ server" --body "Description..."

# Cookiecutter로 프로젝트 생성
npx create-mcp-server my-server --template typescript

# 또는 수동 클론
git clone https://github.com/modelcontextprotocol/typescript-server-template
cd typescript-server-template
npm install
npm run build

# Cookiecutter로 프로젝트 생성
cookiecutter gh:modelcontextprotocol/python-server-template

# 또는 수동 설정
git clone https://github.com/modelcontextprotocol/python-server-template
cd python-server-template
pip install -e .

// 문서 동기화 워크플로우
async function syncDocuments() {
  // 1. 로컬 Markdown 파일 읽기
  const mdFiles = await readLocalMarkdown('./docs');

  // 2. Notion 페이지 동기화
  for (const file of mdFiles) {
    const pageId = await findOrCreateNotionPage(file.title);
    await updateNotionPage(pageId, file.content);
  }

  // 3. PDF 변환 및 Google Drive 업로드
  const pdfFiles = await convertToPDF(mdFiles);
  await uploadToGoogleDrive(pdfFiles, 'project-docs');

  console.log(`✅ ${mdFiles.length}개 문서 동기화 완료`);
}

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxx"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://readonly:pass@localhost/mydb"]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "BSA_xxxx"
      }
    }
  }
}

{
  "mcpServers": {
    "gateway": {
      "command": "node",
      "args": ["./mcp-gateway/index.js"],
      "env": {
        "GATEWAY_CONFIG": "./gateway-config.json",
        "AUTH_MODE": "oauth2",
        "LOG_LEVEL": "info",
        "RATE_LIMIT": "100/min"
      }
    }
  }
}

# 방법 1: .env 파일 사용 (Git에서 제외할 것)
# .env 파일 생성
cat > ~/.mcp/.env << 'EOF'
GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
BRAVE_API_KEY=BSA_xxxxxxxxxxxxxxxxxxxx
SLACK_BOT_TOKEN=xoxb-xxxxxxxxxxxxxxxxxxxx
DB_CONNECTION=postgresql://readonly:pass@localhost/mydb
EOF

# 파일 권한 제한 (소유자만 읽기)
chmod 600 ~/.mcp/.env

# 방법 2: OS 키체인/시크릿 매니저 사용 (macOS 예시)
security add-generic-password -s "mcp-github" -a "token" -w "ghp_xxxx"

# 방법 3: 1Password CLI 등 외부 시크릿 매니저 연동
export GITHUB_TOKEN=$(op read "op://Private/GitHub MCP/token")