mcp_server/
├── src/
│   ├── __init__.py
│   ├── main.py              # FastAPI 서버
│   ├── mcp_client.py        # MCP 클라이언트
│   ├── mcp_server.py        # MCP 서버 메인
│   ├── tools/               # MCP 도구들
│   │   ├── __init__.py
│   │   └── search_docs.py   # 검색 도구
│   └── utils/               # 유틸리티 함수들
│       ├── __init__.py
│       ├── gemini.py        # Gemini AI 함수
│       └── naver_search.py  # 네이버 검색 함수
├── tests/
│   └── test_api.py          # API 테스트
├── docs/                    # 참고 문서
│   ├── ai_deps              # Gemini 참고 코드
│   └── search_deps          # 네이버 검색 참고 코드
├── requirements.txt         # Python 의존성
├── pyproject.toml          # 프로젝트 설정
├── README.md               # 이 파일
└── .gitignore              # Git 제외 파일

pip install -r requirements.txt

NAVER_CLIENT_ID = 'your_client_id'
NAVER_CLIENT_SECRET = 'your_client_secret'

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "/path/to/your/credentials.json"

cd /Users/yanghyojun/Desktop/mcp_server
python -m src.main

uvicorn src.main:app --reload --host 0.0.0.0 --port 8001

curl -X POST "http://localhost:8001/search" \
  -H "Content-Type: application/json" \
  -d '{"query": "Python 공식 문서"}'

{
  "result": "'Python 공식 문서'에 대한 공식 문서를 찾았습니다:\n\n1. Python 공식 문서\n   URL: https://docs.python.org/ko/3/\n   설명: Python 프로그래밍 언어의 공식 문서...\n\n",
  "query": "Python 공식 문서"
}

python tests/test_api.py

cd /Users/yanghyojun/Desktop/mcp_server
python -m src.main

# 메인 FastAPI 서버 코드
import httpx
from fastapi import HTTPException

@app.post("/search-docs")
async def search_official_docs(query: str):
    """공식 문서 검색"""
    try:
        async with httpx.AsyncClient() as client:
            response = await client.post(
                "http://localhost:8001/search",
                json={"query": query},
                timeout=30.0
            )
            response.raise_for_status()
            return response.json()
    except httpx.RequestError as e:
        raise HTTPException(status_code=503, detail=f"MCP 서버 연결 실패: {str(e)}")

python -m src.mcp_server

{
  "mcpServers": {
    "naver-search-docs": {
      "command": "python",
      "args": ["-m", "src.mcp_server"],
      "cwd": "/Users/yanghyojun/Desktop/mcp_server"
    }
  }
}

# src/tools/my_new_tool.py
from typing import Any, List
from mcp import types

class MyNewTool:
    """새로운 도구 설명"""

    @staticmethod
    def get_tool_definition() -> types.Tool:
        """도구 정의 반환"""
        return types.Tool(
            name="my_new_tool",
            description="도구 설명",
            inputSchema={
                "type": "object",
                "properties": {
                    "param": {
                        "type": "string",
                        "description": "파라미터 설명"
                    }
                },
                "required": ["param"]
            }
        )

    @staticmethod
    async def execute(arguments: dict[str, Any]) -> List[types.TextContent]:
        """도구 실행"""
        # 도구 로직 구현
        return [types.TextContent(
            type="text",
            text="결과"
        )]

from .my_new_tool import MyNewTool

__all__ = [
    "SearchDocsTool",
    "MyNewTool",  # 추가
]

from .tools import SearchDocsTool, MyNewTool

TOOLS = [
    SearchDocsTool,
    MyNewTool,  # 추가
]