SDK MCP Server

SDK MCP Server

Un servidor Model Context Protocol (MCP) configurable que proporciona acceso buscable a la documentación y el código fuente de múltiples SDK de IA/ML. Actualmente admite OpenAI Agents SDK y Google ADK, con fácil extensibilidad para SDK adicionales.

Propósito

Cuando trabajas con SDK de IA/ML, a menudo necesitas:

• Entender cómo funcionan internamente las clases y métodos en diferentes SDK
• Comparar implementaciones entre diferentes frameworks
• Encontrar las firmas y parámetros de métodos correctos
• Ver ejemplos de implementación reales
• Depurar problemas examinando el código fuente del SDK

Este servidor MCP brinda a asistentes de IA como Claude acceso instantáneo a múltiples fuentes de SDK, lo que lo convierte en un poderoso compañero de desarrollo para proyectos multi-SDK.

Inicio Rápido

1. Instala las dependencias:

pip install -r requirements.txt

2. Descarga las fuentes del SDK:

python src/download_sdk.py

Esto descargará todos los SDK configurados desde sdks.yaml.

3. Configura en Claude Desktop:

Añade a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "sdk-mcp-server": {
      "command": "python",
      "args": ["/absolute/path/to/sdk-mcp-server/src/server.py"]
    }
  }
}

Herramientas Disponibles

Cada SDK configurado obtiene su propio conjunto de herramientas con el prefijo del SDK. Actualmente configurado:

Herramientas de OpenAI Agents SDK (prefijo: openai_agents_)

• openai_agents_list_files() - Lista todos los archivos fuente disponibles del OpenAI SDK
• openai_agents_get_source(filename) - Obtiene el código fuente de un archivo específico
• openai_agents_search_code(query) - Busca términos, métodos o patrones
• openai_agents_get_class(class_name) - Extrae la definición completa de una clase
• openai_agents_find_examples(topic) - Encuentra ejemplos de uso y patrones

Herramientas de Google ADK (prefijo: google_adk_)

• google_adk_list_files() - Lista todos los archivos fuente disponibles de Google ADK
• google_adk_get_source(filename) - Obtiene el código fuente de un archivo específico
• google_adk_search_code(query) - Busca términos, métodos o patrones
• google_adk_get_class(class_name) - Extrae la definición completa de una clase
• google_adk_find_examples(topic) - Encuentra ejemplos de uso y patrones

Herramientas Multi-SDK (próximamente)

• list_available_sdks() - Muestra todos los SDK configurados
• search_all_sdks(query) - Busca en todos los SDK simultáneamente
• compare_implementations(concept, sdk_ids) - Compara conceptos similares entre SDK

Ejemplos de Uso

Comparando SDK:

You: "How do OpenAI and Google handle agent creation differently?"
Claude: [Uses openai_agents_get_class("Agent") and google_adk_get_class("Agent")]
*Compares the different approaches and APIs*

Aprendiendo un nuevo SDK:

You: "Show me how to use tools in Google ADK"
Claude: [Uses google_adk_search_code("tool") and google_adk_find_examples("tool")]
*Explains Google's approach with real examples*

Depurando entre SDK:

You: "Why does handoff work in OpenAI but not in my Google ADK code?"
Claude: [Searches both SDKs for handoff implementations]
*Identifies the differences and helps fix the issue*

Configuración

Añadiendo un Nuevo SDK

Edita sdks.yaml para añadir nuevos SDK:

sdks:
  your_sdk:
    name: "Your SDK Name"
    description: "Description of the SDK"
    source:
      type: "github"
      repo: "org/repo-name"
      branch: "main"
      path: "src"
    file_patterns:
      - "**/*.py"
    tools:
      prefix: "your_sdk"
      descriptions:
        list_files: "List all Your SDK source files"
        # ... other tool descriptions

Tipos de Fuente Soportados

• Repositorios de GitHub - Repos públicos con código Python/TypeScript
• URLs directas (próximamente) - Archivos ZIP/TAR
• Rutas locales (próximamente) - Instalaciones locales de SDK

Estructura de Archivos

sdk-mcp-server/
├── src/
│   ├── server.py           # Main MCP server implementation
│   └── download_sdk.py     # SDK downloader and indexer
├── data/                   # Downloaded SDK files (git-ignored)
│   ├── openai_agents/      # OpenAI SDK files
│   └── google_adk/         # Google ADK files
├── sdks.yaml              # SDK configuration
├── requirements.txt       # Python dependencies
└── run_server.sh         # Server startup script

Actualización

Para obtener las últimas fuentes del SDK:

python src/download_sdk.py

Esto obtiene el código más reciente de todos los SDK configurados en sdks.yaml.

Consejos para Mejores Resultados

1. Especifica el SDK - Menciona con qué SDK estás trabajando
2. Usa prefijos de SDK - Cada herramienta tiene el prefijo del nombre del SDK
3. Compara implementaciones - Pregunta sobre las diferencias entre SDK
4. Solicita ejemplos - Cada SDK tiene capacidades de búsqueda de ejemplos

Por Qué Esto Ayuda

• Soporte multi-SDK - Trabaja con múltiples frameworks sin problemas
• Respuestas instantáneas - No necesitas navegar por múltiples repos o documentación
• Comparaciones directas - Ve cómo diferentes SDK resuelven problemas similares
• Información precisa - Siempre desde el código fuente más reciente
• Consciente del contexto - La IA entiende implementaciones completas entre SDK

Contribuciones

Para añadir soporte para un nuevo SDK:

1. Añade configuración a sdks.yaml
2. Prueba con python src/download_sdk.py
3. Envía una solicitud de pull

Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles.