profile-mcp

kazejev.com용 개인 MCP 서버입니다. 이 서버는 Cloudflare Workers에서 실행됩니다. 이 서버는 읽기 전용입니다. AI 에이전트에게 약력, 기술, 프로젝트 및 연락처 링크를 제공합니다. 이 서버에는 런타임 종속성이 없습니다.

언어

이 프로젝트는 Simplified Technical English(ASD-STE100)를 사용합니다. 모든 문서와 모든 코드 주석을 다음 스타일로 작성하십시오:

• 문장을 짧게 유지하십시오. 지시문에는 최대 20단어를 사용하십시오.

• 능동태를 사용하십시오.

• 하나의 의미에는 하나의 단어를 사용하십시오. 같은 것을 나타낼 때는 같은 단어를 사용하십시오.

• 하나의 지시문은 하나의 문장으로 작성하십시오.

Related MCP server: personal-resume-agent

프로토콜 지원

이 서버는 두 가지 프로토콜 시대를 지원합니다.

MCP 2026-07-28 개정판은 initialize 핸드셰이크를 제거했습니다. 또한 프로토콜 수준 세션도 제거했습니다. 따라서 새 개정판용 서버는 이전 개정판용 서버와 매우 다릅니다. 대부분의 클라이언트는 여전히 이전 개정판을 사용합니다. 따라서 이 서버는 하나의 엔드포인트에서 두 시대를 지원합니다.

서버는 각 요청에 대해 시대를 선택합니다. MCP-Protocol-Version 헤더가 모던 버전을 표시하면 서버는 모던 규칙을 사용합니다. 그렇지 않으면 서버는 레거시 규칙을 사용합니다.

모던 시대에는 다음 규칙이 있습니다:

• 서버는 GET 요청 및 DELETE 요청에 대해 405를 보냅니다. GET 스트림과 세션 종료는 더 이상 프로토콜에 포함되지 않습니다.

• 클라이언트는 Mcp-Method 헤더를 보내야 합니다. tools/call, resources/read 및 prompts/get의 경우 클라이언트는 Mcp-Name 헤더도 보내야 합니다.

• 헤더 값이 본문 값과 일치하지 않으면 서버는 400 및 오류 코드 -32020(HeaderMismatch)을 보냅니다. 서버는 먼저 =?base64?…?= 형식을 디코딩한 다음 두 값을 비교합니다.

• 서버가 프로토콜 버전을 지원하지 않으면 서버는 400 및 오류 코드 -32022를 보냅니다. 오류 데이터에는 지원되는 버전이 표시됩니다.

• 메서드를 알 수 없으면 서버는 404 및 오류 코드 -32601을 보냅니다. 클라이언트는 이 응답을 사용하여 모던 서버를 식별합니다.

• 목록 결과에는 ttlMs와 cacheScope가 포함됩니다. 각 결과에는 resultType이 포함됩니다.

서버에는 subscriptions/listen, MRTR 입력 요청 또는 tasks 확장이 없습니다. 각 도구는 정적이고 인수가 없으므로 서버에는 이러한 기능이 필요하지 않습니다.

엔드포인트

POST /mcp. 서버는 다른 모든 경로에 404를 보냅니다.

파일

src/content.ts    All personal content. You change this file frequently.
src/protocol.ts   The MCP methods. This file is independent of the transport.
src/index.ts      The Cloudflare Worker entry point.
test/smoke.mjs    The protocol tests.

개발

npm install
npm run typecheck
npm test          # Compiles the code, then does the tests.
npm run dev       # Starts wrangler dev.

배포

npx wrangler login
npx wrangler deploy

그런 다음 Cloudflare 대시보드에서 사용자 지정 도메인 mcp.kazejev.com을 추가하십시오. Workers & Pages로 이동한 다음 이 Worker, Settings, Domains & Routes로 이동하십시오.

서버 카드

theglobe/theglobe.github.io 저장소는 /.well-known/mcp/server-card.json에서 디스커버리 카드를 보냅니다. 카드의 protocolVersion 필드와 transport.endpoint 필드는 이 서버와 일치해야 합니다.

카드는 서버 이름 kazejev-personal을 제공합니다. 이 이름은 저장소 이름 및 Worker 이름과 다릅니다. 카드도 변경하지 않는 한 src/content.ts의 SERVER_NAME을 변경하지 마십시오.

할 일

• src/content.ts에 올바른 약력, 기술 및 프로젝트를 넣으십시오.

• 연락처 이메일 주소를 결정하십시오. 이 파일에는 이메일 주소가 없습니다.

레지스트리

이 서버는 공식 MCP Registry에 com.kazejev/profile로 등록되어 있습니다.

https://registry.modelcontextprotocol.io/v0/servers?search=kazejev

server.json에는 레지스트리 항목이 들어 있습니다. 새 버전을 게시하려면 version 필드를 src/content.ts의 SERVER_VERSION과 일치하도록 변경한 다음:

mcp-publisher login dns --domain kazejev.com --private-key <HEX>
mcp-publisher publish

com.kazejev 네임스페이스는 kazejev.com의 TXT 레코드로 증명됩니다:

v=MCPv1; k=ed25519; p=Z3Hxdi1IjSf8w1F4nnlcPJHX/X72+rsaXY4DTJJj5Ns=

해당 레코드는 그대로 유지되어야 합니다. 일치하는 개인 키는 이 저장소에 없습니다. 다른 키를 사용하려면 새 키 쌍을 생성하고 TXT 레코드를 새 공개 키로 교체하십시오.