91 lines
2.2 KiB
Markdown
91 lines
2.2 KiB
Markdown
# 🧠 mi-mcp-server
|
|
|
|
Servidor MCP (Model Context Protocol) personalizado para exponer herramientas propias como funciones accesibles desde LLMs compatibles (Gemini, Claude, etc).
|
|
|
|
Este server corre en Docker y puede ser usado directamente desde stdio usando el SDK de MCP.
|
|
|
|
---
|
|
|
|
## 📦 Herramientas expuestas
|
|
|
|
Actualmente expone:
|
|
|
|
- `saludar`: saluda a una persona por su nombre.
|
|
|
|
Podés modificar o agregar más herramientas editando el archivo `tools.js`.
|
|
|
|
---
|
|
|
|
## 🛠️ Estructura del proyecto
|
|
|
|
.
|
|
├── Dockerfile # Imagen mínima de Node.js con tu server MCP
|
|
├── index.js # Punto de entrada, arranca el servidor MCP
|
|
├── tools.js # Define tus herramientas y su lógica
|
|
├── package.json # Dependencias (usa @modelcontextprotocol/server)
|
|
└── .gitea/workflows/
|
|
└── build.yml # Workflow para construir y subir imagen a tu Gitea registry
|
|
|
|
yaml
|
|
Copy
|
|
Edit
|
|
|
|
---
|
|
|
|
## 🐳 Construcción local
|
|
|
|
```bash
|
|
docker build -t mi-mcp-server .
|
|
docker run -it --rm mi-mcp-server
|
|
🐙 Construcción automática (Gitea Actions)
|
|
Este repositorio ya incluye un workflow (.gitea/workflows/build.yml) que:
|
|
|
|
Se activa en cada push a main
|
|
|
|
Construye la imagen
|
|
|
|
La sube al registry interno: gitea.interno.com/tu_usuario/mi-mcp-server:latest
|
|
|
|
🧪 Uso desde un cliente MCP
|
|
js
|
|
Copy
|
|
Edit
|
|
import { Client } from '@modelcontextprotocol/sdk/client';
|
|
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio';
|
|
|
|
const client = new Client({ name: 'local', version: '1.0.0' });
|
|
|
|
await client.connect(new StdioClientTransport({
|
|
command: 'docker',
|
|
args: ['run', '-i', '--rm', 'gitea.interno.com/tu_usuario/mi-mcp-server:latest']
|
|
}));
|
|
|
|
const tools = await client.listTools(); // ver herramientas disponibles
|
|
const result = await client.callTool({
|
|
name: 'saludar',
|
|
arguments: { nombre: 'Darío' }
|
|
});
|
|
|
|
console.log(result.content[0].text); // → Hola, Darío! 👋
|
|
🔐 Notas
|
|
Si tu imagen necesita variables de entorno, podés usar -e en el args de Docker.
|
|
|
|
Asegurate de que tu bot o app tenga acceso a Docker en el entorno donde corre.
|
|
|
|
©️ Licencia
|
|
MIT — ajustala si vas a distribuir como código cerrado.
|
|
|
|
go
|
|
Copy
|
|
Edit
|
|
|
|
¿Querés que te empaquete esto como zip inicial listo para clonar, con `package.json`, `Dockerfile` y `tools.js`?
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|