MCP 파워 도구 — Claude의 능력 확장

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost:5432/mydb"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your-token"
      }
    }
  }
}

// 프로젝트 루트/.mcp.json (팀 공유, git 커밋 가능)
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}

// ~/.claude/settings.json (개인용, 모든 프로젝트에서 사용 가능)
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@anthropic/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your-personal-key"
      }
    }
  }
}

// 예시: 내부 위키를 검색하는 MCP 서버 개념
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 
const server = new Server({ name: "internal-wiki", version: "1.0.0" });
 
// 도구 등록: Claude가 이 함수를 호출할 수 있게 됩니다
server.setRequestHandler("tools/call", async (request) => {
  if (request.params.name === "search_wiki") {
    const query = request.params.arguments.query;
    // 내부 위키 API 호출
    const results = await internalWikiApi.search(query);
    return { content: [{ type: "text", text: JSON.stringify(results) }] };
  }
});

claude mcp list

{
  "mcpServers": {
    "slow-server": {
      "command": "npx",
      "args": ["-y", "some-mcp-server"],
      "timeout": 30000
    }
  }
}

claude --mcp-debug

pip install mcp

from mcp.server import Server
from mcp.types import Tool, TextContent
import mcp.server.stdio
 
app = Server("internal-api")
 
@app.list_tools()
async def list_tools():
    return [
        Tool(
            name="search_docs",
            description="Search internal documentation",
            inputSchema={
                "type": "object",
                "properties": {
                    "query": {"type": "string", "description": "Search query"}
                },
                "required": ["query"]
            }
        )
    ]
 
@app.call_tool()
async def call_tool(name: str, arguments: dict):
    if name == "search_docs":
        results = await internal_api.search(arguments["query"])
        return [TextContent(type="text", text=str(results))]
 
async def main():
    async with mcp.server.stdio.stdio_server() as (read, write):
        await app.run(read, write, app.create_initialization_options())

{
  "mcpServers": {
    "internal-api": {
      "command": "python",
      "args": ["-m", "my_mcp_server"]
    }
  }
}

{
  "mcpServers": {
    "postgres": { "...": "DB 쿼리와 스키마" },
    "github": { "...": "PR과 이슈 관리" },
    "context7": { "...": "라이브러리 최신 문서" }
  }
}

{
  "mcpServers": {
    "postgres": { "...": "데이터 웨어하우스 쿼리" },
    "filesystem": { "...": "여러 레포 접근" },
    "memory": { "...": "세션 간 컨텍스트" }
  }
}

{
  "mcpServers": {
    "sentry": { "...": "에러 모니터링" },
    "docker": { "...": "컨테이너 관리" },
    "github": { "...": "배포 워크플로우" }
  }
}

## MCP 도구 사용 규칙
- DB 스키마 질문 → postgres MCP 먼저, 추측 금지
- 외부 라이브러리 → context7로 최신 문서 확인 후 구현
- 이슈 생성/업데이트 → GitHub MCP 사용, 수동 API 호출 금지
- 웹 검색이 필요하면 → brave-search MCP 사용
- 내부 문서 참조 → internal-wiki MCP로 검색