AI导哈

HTTP服务工具

MCP Server y Cliente 是一个基于HTTP的MCP服务器，提供say_hello和count_r工具，适用于简单的客户端-服务器交互场景。

  • by Alexevh
  • PowerShell
  • 本地部署
  • 更新于
在 GitHub 查看 Alexevh/hello_mcp

使用说明

MCP Server y Cliente (say_hello)

Servidor MCP sobre HTTP (TCP) que expone la herramienta say_hello(name) y cliente que la consume.

  • Transporte: HTTP en http://127.0.0.1:8765/mcp (configurable)
  • Idioma por defecto: español
  • Punto de entrada servidor: say_hello.py
  • Cliente: client.py
  • Herramientas disponibles en el mismo servidor: say_hello y count_r

Requisitos

  • Python 3.12+
  • Windows PowerShell (este repo está configurado en Windows)

Instalación de dependencias

Con pip (global o venv):

python -m pip install --upgrade pip
python -m pip install fastmcp anyio mcp

Opcional con uv (si tienes uv):

uv pip install fastmcp anyio mcp
``;

## Variables de entorno (opcionales)
- `MCP_URL` (tiene prioridad si está definido). Ejemplo: `https://evolutionary-fuchsia-shark.fastmcp.app/mcp`
- `MCP_API_KEY` (si está definido, el cliente envía `Authorization: Bearer <MCP_API_KEY>`) 
- `MCP_HOST` (default `127.0.0.1`)
- `MCP_PORT` (default `8765`)
- `MCP_HTTP_PATH` (default `/mcp`)

## Ejecutar el servidor

python say_hello.py


Esto levanta el servidor MCP HTTP en `http://127.0.0.1:8765/mcp`.

## Ejecutar el cliente

Con `.env` (recomendado para despliegue FastMCP): crea un archivo `.env` con:

MCP_URL=https://evolutionary-fuchsia-shark.fastmcp.app/mcp MCP_API_KEY=tu_api_key

python client.py --name "Lucía"


Salida esperada:

Hola, Lucía


También puedes usar la tool `count_r` (cuenta 'r' y 'R'):

python client.py --count-r "Río arriba"


Salida esperada (ejemplo):

2


## Errores comunes
- Nombre vacío: `El nombre es requerido` (exit code 1)
- Nombre >256: `El nombre excede 256 caracteres` (exit code 1)
- Servidor no disponible: error de conexión (exit code 1)

## Notas
- `.windsurf/` está en `.gitignore` por seguridad.
- Puerto configurable vía `MCP_PORT`; si está ocupado, el servidor fallará en el arranque.

相关 MCP