Tu primer servidor MCP
26 julio, 2025
- Creando el tool o herramienta de nuestro mcp server para consultar usuarios de nuestra base de datos
- Conectando una IA a nuestro mcp server
- Posibles fallos
Vamos a hacer que la IA de Claude desktop hable con nuestra base de datos para poder pedirle consultas como “dame los nombres de usuarios que empiecen por a en mi base de datos”.
Model Context Protocol Server es un agente que se conecta a una IA o un LLM para dotarlo de más datos y que pueda por ejemplo consulte los datos de tu base de datos haciéndole al LLM la pregunta de “muéstrame todos los usuarios que empiecen por a” o enviar un correo diciéndole “envía correos a los clientes de Alicante” o enviar twit, etc.
Pero claro, no solo sirve para hablar con tu base de datos local, también puedes utilizarlo para que te explique un proyecto de github conectándolo aún agente mcp server de github, que le preguntes sobre el clima de mañana conectándolo a un mcp server de weather, etc, existe una base de datos oficial con estos servidores: https://github.com/modelcontextprotocol/servers
El repositorio oficial https://github.com/modelcontextprotocol tiene ya librerías para que podamos crear mcp servers utilizando nuestro lenguaje favorito.
Vamos a crear nuestro mcp sever utilizando python, para ver como se hace, vamos al repositorio oficial y pinchamos en Python SDK:
Ahora en installation:
Lo 1 que nos dice es que utilizemos el manejador de proyectos Python uv, vamos a instalar uv de forma global con pip install uv ya que nos hará falta para más tarde, pero para hacerlo lo más sencillo posible, vamos a utilizar nuestro pip y nuestro entorno virtual venv como siempre, creamos un archivo llamado main.py con “echo “” >main.py”, después escribimos “python -m venv .venv” para crear nuestro entorno virtual, cuando vscode nos pida utilizarlo le decimos que si, si no lo pregunta, presionamos ctrl+shift+p y escribimos python interpreter y seleccionamos en (.venv):
Lo activamos con .venv\Scripts\activate y escribimos pip install mcp mcp[cli] para instalar el paquete mcp que nos permitirá crear mcp servers y cliente de línea de comandos mcp[cli] que nos permitirá escribir comando en el terminal o cmd del mcp como por ejemplo “mcp dev main.py” para ejecutar un pequeño servidor de pruebas:
Ahora dentro del main.py escribimos el código para inicializar nuestro mcp:
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("Demo")
if __name__ == "__main__":
mcp.run()
Por último escribimos “mcp dev main.py”, cuando nos pregunte que inspector queremos utilizar pulsamos intro, el inspector es una pequeña aplicación web que nos va a permitir probar los mcp servers que vayamos creando:
Cuando termina nos abre una web, pinchamos en connect para ver si hay algún problema, en la parte de debajo de este artículo he puesto los posibles problemas que te puedes encontrar.
Todo ha ido bien:
Creando el tool o herramienta de nuestro mcp server para consultar usuarios de nuestra base de datos
Creamos el archivo sqliteClient.py con este código:
import sqlite3
import os
class SqliteClient:
def connect(self):
self.SQLITE_DB="agenda.db"
inicializar_bd=False
if not os.path.exists(self.SQLITE_DB):
inicializar_bd=True
try:
self.connection=sqlite3.connect(self.SQLITE_DB, check_same_thread=False)
#print("Conexión existosa a base de datos sqlite")
self.cursor=self.connection.cursor()
self.cursor.execute("PRAGMA foreign_keys=ON");
self.connection.commit()
except Exception as e:
print(f"currió un error al conectar con sqlite: {e}")
if inicializar_bd:
self.create_table_usuario()
self.add_fake_users()
def close(self):
if self.connection!=None:
self.connection.close()
def get_connection(self):
return self.connection
def get_cursor(self):
return self.cursor
def reset(self):
self.cursor.execute("DROP TABLE IF EXISTS usuario")
self.connection.commit()
self.create_table_usuario()
self.add_fake_users()
# USUARIOS
#######################################################
def create_table_usuario(self):
self.cursor.execute('''
CREATE TABLE IF NOT EXISTS usuarios (
id_usuario INTEGER PRIMARY KEY AUTOINCREMENT,
nombre_usuario varchar(20),
clave_usuario varchar(255),
apellidos_usuario varchar(50),
rol varchar(20) default 'normal'
);
''')
self.connection.commit()
def add_fake_users(self):
self.cursor.executemany("insert into usuarios (`nombre_usuario`, `clave_usuario`, `apellidos_usuario`, `rol`)values (?,?,?,?);",
[
('kike','1234', 'martinez', 'administrador'),
('carlos','1234', 'lopez', 'administrador'),
('pablo','1234', 'perez', 'normal'),
('loreto','1234', 'rodriguez', 'normal'),
('teo','1234', 'torres', 'normal'),
('sergio','1234', 'lopez', 'normal'),
('david','1234', 'rodriguez', 'normal')
]
)
self.connection.commit()
def obtener_todos_los_usuarios(self):
self.cursor.execute("SELECT * FROM usuarios")
tuplas=self.cursor.fetchall()
return tuplas
Modificamos el main.py para añadir el @mcp.tool, los comentarios son muy importantes ya que ayudan a las IAs que se conectan:
from mcp.server.fastmcp import FastMCP
from sqliteClient import SqliteClient
mcp = FastMCP("Demo")
sqlite=SqliteClient()
sqlite.connect()
@mcp.tool()
async def muestra_todos_los_usuarios():
"""
Usa esta función para obtener todos los usuarios de la tabla usuarios
Args:
None
Returns:
dict: Un diccionario con todos los usuarios, donde la clave es el ID del usuario y el valor es un diccionario con los datos del usuario.
"""
usuarios=sqlite.obtener_todos_los_usuarios()
return {
usuario[0]: {
"nombre_usuario": usuario[1],
"clave_usuario": usuario[2],
"apellidos_usuario": usuario[3],
"rol": usuario[4]
} for usuario in usuarios
}
if __name__ == "__main__":
#mcp.run()
Para probar nuestro @mcp.tool dentro de la web pinchamos en Tools:
Ahora en List Tools:
Ahora en nuestra tool “muestra_todos_los_usuarios”:
Ahora pinchamos en Run Tool:
Conectando una IA a nuestro mcp server
Puedes utilizar la IA integrada de github copilot, windsurf, cursor, pero nostros vamos a probar claude desktop, nos lo descargamos de https://claude.ai/download.
Elegimos el plan gratuito, claro:
Una vez instalados y logeados tenemos que indicarle a Claude desktop donde van a estar nuestros mcp-servers.
Ahora toca crear el archivo “claude_desktop_config.json” en el directorio “C:\Users\tu_usuario\AppData\Roaming\Claude” especificando los mcp servers que quieres que vea Claude desktop:
Dentro del archivo “claude_desktop_config.json”, escribimos el comando y la ruta de nuestro mcp server, en lugar de tu_usuario pon el usuario de Windows que tengas:
{
"mcpServers": {
"mcp-sqlite": {
"command": "uv",
"args": [
"--directory",
"C:/Users/tu_usuario/Desktop/mcp-test/sqlite",
"run",
"main.py"
]
}
}
}
Si quieres puedes preguntarle a Claude-destop sobre la ruta de la configuración de los mcp:
Ahora cerramos y volvemos a abrir Claude desktop y pinchamos aquí:
Administrar conectores:
Aquí verás tu mcp server:
Ahora toca hacerle la pregunta:
Toca darle los permisos:
Perfecto, hagamos otra pregunta:
Posibles fallos
Error al intentar crear el servidor web
Tenemos que actualizar las librerías de node para crear el servidor web , para eso crearemos un script en power shell, crea un archivo llamado “mcp-install.ps1”, puedes descargarlo de aquí: https://gist.github.com/evalstate/d0420dc6925f603b944c8b19e8b6977c
Ejecuta el archivo dentro de power Shell con “.\mcp-install.ps1 @modelcontextprotocol/server-everything”:
