SDK MCP Server

SDK MCP Server

Um servidor configurável de Model Context Protocol (MCP) que fornece acesso pesquisável à documentação e ao código-fonte de múltiplos SDKs de IA/ML. Atualmente suporta OpenAI Agents SDK e Google ADK, com fácil extensibilidade para SDKs adicionais.

Propósito

Ao trabalhar com SDKs de IA/ML, você frequentemente precisa:

• Entender como classes e métodos funcionam internamente em diferentes SDKs
• Comparar implementações entre diferentes frameworks
• Encontrar as assinaturas e parâmetros de métodos corretos
• Ver exemplos reais de implementação
• Depurar problemas examinando o código-fonte dos SDKs

Este servidor MCP dá a assistentes de IA como o Claude acesso instantâneo a múltiplas fontes de SDK, tornando-o um poderoso companheiro de desenvolvimento para projetos multi-SDK.

Início Rápido

1. Instalar dependências:

pip install -r requirements.txt

2. Baixar fontes dos SDKs:

python src/download_sdk.py

Isso fará o download de todos os SDKs configurados de sdks.yaml.

3. Configurar no Claude Desktop:

Adicione à sua configuração do Claude Desktop:

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

Ferramentas Disponíveis

Cada SDK configurado recebe seu próprio conjunto de ferramentas com o prefixo do SDK. Atualmente configurado:

Ferramentas do OpenAI Agents SDK (prefixo: openai_agents_)

• openai_agents_list_files() - Listar todos os arquivos de código-fonte do OpenAI SDK disponíveis
• openai_agents_get_source(filename) - Obter o código-fonte de um arquivo específico
• openai_agents_search_code(query) - Pesquisar por termos, métodos ou padrões
• openai_agents_get_class(class_name) - Extrair a definição completa de uma classe
• openai_agents_find_examples(topic) - Encontrar exemplos de uso e padrões

Ferramentas do Google ADK (prefixo: google_adk_)

• google_adk_list_files() - Listar todos os arquivos de código-fonte do Google ADK disponíveis
• google_adk_get_source(filename) - Obter o código-fonte de um arquivo específico
• google_adk_search_code(query) - Pesquisar por termos, métodos ou padrões
• google_adk_get_class(class_name) - Extrair a definição completa de uma classe
• google_adk_find_examples(topic) - Encontrar exemplos de uso e padrões

Ferramentas Cross-SDK (em breve)

• list_available_sdks() - Mostrar todos os SDKs configurados
• search_all_sdks(query) - Pesquisar em todos os SDKs simultaneamente
• compare_implementations(concept, sdk_ids) - Comparar conceitos semelhantes entre SDKs

Exemplos de Uso

Comparando SDKs:

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*

Aprendendo um novo 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 SDKs:

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*

Configuração

Adicionando um Novo SDK

Edite sdks.yaml para adicionar novos SDKs:

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 Fonte Suportados

• Repositórios do GitHub - Repositórios públicos com código Python/TypeScript
• URLs diretas (em breve) - Arquivos ZIP/TAR
• Caminhos locais (em breve) - Instalações locais de SDKs

Estrutura de Arquivos

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

Atualização

Para obter as fontes mais recentes dos SDKs:

python src/download_sdk.py

Isso busca o código mais recente de todos os SDKs configurados em sdks.yaml.

Dicas para Melhores Resultados

1. Especifique o SDK - Mencione com qual SDK você está trabalhando
2. Use os prefixos do SDK - Cada ferramenta é prefixada com o nome do SDK
3. Compare implementações - Pergunte sobre diferenças entre SDKs
4. Solicite exemplos - Cada SDK possui recursos de localização de exemplos

Por que Isso Ajuda

• Suporte multi-SDK - Trabalhe com múltiplos frameworks de forma integrada
• Respostas instantâneas - Sem necessidade de navegar por vários repositórios ou documentações
• Comparações diretas - Veja como diferentes SDKs resolvem problemas semelhantes
• Informações precisas - Sempre a partir do código-fonte mais recente
• Consciente do contexto - A IA entende implementações completas entre SDKs

Contribuindo

Para adicionar suporte a um novo SDK:

1. Adicione a configuração em sdks.yaml
2. Teste com python src/download_sdk.py
3. Envie um pull request

Licença

Licença MIT - consulte o arquivo LICENSE para mais detalhes.