mcp-server-starter

Python으로 Model Context Protocol (MCP) 서버를 구축하기 위한 스켈레톤입니다. Claude Desktop, Claude Code 또는 기타 MCP 호환 클라이언트에 사용자 지정 도구/데이터 세트를 노출해야 할 때 이 저장소를 포크하여 사용하세요.

MCP 서버란 무엇인가요?

MCP는 언어 모델 클라이언트가 표준 인터페이스를 통해 외부 도구 및 데이터 소스를 호출할 수 있도록 하는 개방형 프로토콜입니다. MCP 서버는 이러한 도구를 호스팅하는 작은 프로세스입니다. 사용자가 함수를 작성하면 프로토콜이 검색 및 호출을 처리합니다.

퀵스타트

pipx를 사용하여 이 저장소에서 직접 설치하세요:

pipx install git+https://github.com/roderickch01/mcp-server-starter.git

그런 다음 MCP 클라이언트에 등록하세요. Claude Desktop의 경우 ~/.config/Claude/claude_desktop_config.json(Linux), ~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json(Windows)을 편집하고 다음을 추가하세요:

{
  "mcpServers": {
    "starter": {
      "command": "mcp-server-starter"
    }
  }
}

이 스니펫의 복사본은 examples/claude_desktop_config.json에 있습니다. 클라이언트를 다시 시작하면 echo 및 add 도구가 나타날 것입니다.

포함된 내용

연결을 확인하기 위한 두 가지 데모 도구:

echo(text: str) -> str — "echo: {text}"를 반환합니다.
add(a: int, b: int) -> int — 합계를 반환합니다.

둘 다 src/mcp_server_starter/server.py에 있습니다(30줄 미만).

나만의 도구 추가하기

server.py를 열고 @mcp.tool()로 함수를 데코레이트하세요. 함수 시그니처, 타입 힌트, 독스트링이 자동으로 도구의 스키마가 됩니다:

@mcp.tool()
def reverse(text: str) -> str:
    """Return the input string reversed."""
    return text[::-1]

재설치(pipx reinstall mcp-server-starter) 후 MCP 클라이언트를 다시 시작하세요. 새로운 도구를 검색할 수 있게 됩니다.

로컬 개발

git clone https://github.com/roderickch01/mcp-server-starter.git
cd mcp-server-starter
python -m venv .venv && source .venv/bin/activate
pip install -e .
mcp-server-starter   # runs the server over stdio