Examples and Use Cases

from mcp.server import Server
from mcp.types import Resource, Tool, TextContent
import mcp.types as types
import os

app = Server("file-server")

@app.list_resources()
async def list_resources() -> list[Resource]:
    """Lista archivos en un directorio"""
    resources = []
    base_path = os.getenv("DOCS_PATH", "./docs")
    
    for root, dirs, files in os.walk(base_path):
        for file in files:
            file_path = os.path.join(root, file)
            uri = f"file://{file_path}"
            resources.append(Resource(
                uri=uri,
                name=file,
                description=f"Archivo: {file}",
                mimeType="text/plain"
            ))
    return resources

@app.read_resource()
async def read_resource(uri: str) -> str:
    """Lee el contenido de un archivo"""
    if not uri.startswith("file://"):
        raise ValueError("URI inválida")
    
    file_path = uri.replace("file://", "")
    with open(file_path, "r", encoding="utf-8") as f:
        return f.read()

@app.list_tools()
async def list_tools() -> list[Tool]:
    return [
        Tool(
            name="write_file",
            description="Escribe contenido en un archivo",
            inputSchema={
                "type": "object",
                "properties": {
                    "path": {"type": "string"},
                    "content": {"type": "string"}
                },
                "required": ["path", "content"]
            }
        )
    ]

@app.call_tool("write_file")
async def write_file(path: str, content: str) -> TextContent:
    """Escribe contenido en un archivo"""
    with open(path, "w", encoding="utf-8") as f:
        f.write(content)
    return TextContent(text=f"Archivo {path} escrito exitosamente")

if __name__ == "__main__":
    from mcp.server.stdio import stdio_server
    stdio_server(app)

import asyncio
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

async def main():
    # Configurar conexión al servidor
    server_params = StdioServerParameters(
        command="python",
        args=["-m", "my_mcp_server"],
        env=None
    )
    
    # Conectar al servidor
    async with stdio_client(server_params) as (read, write):
        async with ClientSession(read, write) as session:
            # Inicializar la sesión
            await session.initialize()
            
            # Listar recursos disponibles
            resources = await session.list_resources()
            print("Recursos disponibles:")
            for resource in resources.resources:
                print(f"  - {resource.name}: {resource.uri}")
            
            # Leer un recurso
            if resources.resources:
                first_resource = resources.resources[0]
                content = await session.read_resource(first_resource.uri)
                print(f"\nContenido de {first_resource.name}:")
                print(content.contents[0].text)
            
            # Listar herramientas disponibles
            tools = await session.list_tools()
            print("\nHerramientas disponibles:")
            for tool in tools.tools:
                print(f"  - {tool.name}: {tool.description}")
            
            # Llamar a una herramienta
            if tools.tools:
                first_tool = tools.tools[0]
                result = await session.call_tool(
                    first_tool.name,
                    arguments={}
                )
                print(f"\nResultado de {first_tool.name}:")
                print(result.content[0].text)

if __name__ == "__main__":
    asyncio.run(main())