profile-mcp

Servidor MCP personal para kazejev.com. El servidor opera en Cloudflare Workers. El servidor es de solo lectura: proporciona una biografía, habilidades, proyectos y enlaces de contacto a agentes de IA. El servidor no tiene dependencias de tiempo de ejecución.

Language

Este proyecto utiliza inglés técnico simplificado (ASD-STE100). Escribe toda la documentación y todos los comentarios de código en este estilo:

• Mantén las frases cortas. Usa un máximo de 20 palabras para una instrucción.

• Usa la voz activa.

• Usa una palabra para un significado. Usa la misma palabra para la misma cosa.

• Escribe una instrucción en una oración.

Related MCP server: personal-resume-agent

Protocol support

El servidor soporta dos eras de protocolo.

La revisión 2026-07-28 de MCP eliminó el apretón de manos initialize. También eliminó las sesiones a nivel de protocolo. Por lo tanto, un servidor para la nueva revisión es muy diferente de un servidor para las revisiones anteriores. La mayoría de los clientes todavía usan las revisiones anteriores. Por lo tanto, este servidor soporta las dos eras en un solo endpoint.

El servidor selecciona la era para cada solicitud. Si el encabezado MCP-Protocol-Version muestra una versión moderna, el servidor usa las reglas modernas. Si no, el servidor usa las reglas heredadas.

La era moderna tiene estas reglas:

• El servidor envía 405 para una solicitud GET y para una solicitud DELETE. El flujo GET y el cierre de sesión ya no están en el protocolo.

• El cliente debe enviar el encabezado Mcp-Method. Para tools/call, resources/read y prompts/get, el cliente también debe enviar el encabezado Mcp-Name.

• Si un valor de encabezado no coincide con el valor del cuerpo, el servidor envía 400 y el código de error -32020 (HeaderMismatch). El servidor primero decodifica el formato =?base64?…?=, luego compara los dos valores.

• Si el servidor no soporta la versión del protocolo, el servidor envía 400 y el código de error -32022. Los datos de error muestran las versiones soportadas.

• Si el método es desconocido, el servidor envía 404 y el código de error -32601. Un cliente usa esta respuesta para identificar un servidor moderno.

• Un resultado de lista contiene ttlMs y cacheScope. Cada resultado contiene resultType.

El servidor no tiene subscriptions/listen, las solicitudes de entrada MRTR ni la extensión de tareas. El servidor no las necesita, porque cada herramienta es estática y no tiene argumentos.

Endpoint

POST /mcp. El servidor envía 404 para todas las demás rutas.

Files

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.

Development

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

Deployment

npx wrangler login
npx wrangler deploy

Luego agrega el dominio personalizado mcp.kazejev.com en el panel de Cloudflare. Ve a Workers & Pages, luego a este Worker, luego a Settings, luego a Domains & Routes.

Server card

El repositorio theglobe/theglobe.github.io envía una tarjeta de descubrimiento en /.well-known/mcp/server-card.json. El campo protocolVersion y el campo transport.endpoint en la tarjeta deben coincidir con este servidor.

La tarjeta da el nombre del servidor kazejev-personal. Este nombre es diferente del nombre del repositorio y del nombre del Worker. No cambies SERVER_NAME en src/content.ts a menos que también cambies la tarjeta.

To do

• Pon la biografía, habilidades y proyectos correctos en src/content.ts.

• Toma una decisión sobre una dirección de correo electrónico de contacto. El archivo no tiene dirección de correo electrónico.

Registry

El servidor está en el Registro MCP oficial como com.kazejev/profile.

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

server.json contiene la entrada del registro. Para publicar una nueva versión, cambia el campo version para que coincida con SERVER_VERSION en src/content.ts, luego:

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

El espacio de nombres com.kazejev se demuestra mediante un registro TXT en kazejev.com:

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

Ese registro debe permanecer en su lugar. La clave privada correspondiente no está en este repositorio. Para usar una clave diferente, genera un nuevo par y reemplaza el registro TXT con la nueva clave pública.