MCP 서버 템플릿 🛠️

자체 모델 컨텍스트 프로토콜(MCP) 서버를 구축하기 위한 시작 템플릿입니다. 이 템플릿은 Cursor 또는 Claude Desktop과 함께 사용할 수 있는 사용자 지정 MCP를 만드는 데 필요한 기본 구조와 설정을 제공합니다.

특징

TypeScript를 사용한 기본 MCP 서버 설정
샘플 도구 구현
바로 사용 가능한 프로젝트 구조
@modelcontextprotocol/sdk 로 빌드됨

Related MCP server: MCP Server Boilerplate

프로젝트 구조

지엑스피1

시작하기

이 템플릿을 복제하세요:

git clone [your-repo-url] my-mcp-server
cd my-mcp-server

종속성 설치:

pnpm install

프로젝트를 빌드하세요:

pnpm run build

이렇게 하면 /build/index.js 파일, 즉 컴파일된 MCP 서버 스크립트가 생성됩니다.

커서와 함께 사용

커서 설정 -> MCP -> 새 MCP 서버 추가로 이동하세요.
MCP를 구성하세요:
- 이름: [본인의 이름을 선택하세요]
- 유형: 명령
- 명령어: node ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js

Claude Desktop과 함께 사용

다음 MCP 구성을 Claude Desktop 구성에 추가하세요.

{
  "mcpServers": {
    "your-mcp-name": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js"]
    }
  }
}

개발

템플릿에는 index.ts 에 샘플 도구 구현이 포함되어 있습니다. 나만의 MCP를 만들려면 다음을 수행하세요.

index.ts 에서 서버 구성을 수정하세요:

const server = new McpServer({
  name: "your-mcp-name",
  version: "0.0.1",
});

server.tool() 메서드를 사용하여 사용자 정의 도구를 정의합니다.

server.tool(
  "your-tool-name",
  "Your tool description",
  {
    // Define your tool's parameters using Zod schema
    parameter: z.string().describe("Parameter description"),
  },
  async ({ parameter }) => {
    // Implement your tool's logic here
    return {
      content: [
        {
          type: "text",
          text: "Your tool's response",
        },
      ],
    };
  }
);