MCP AI Agent Server

MCP AI Agent Server

Um servidor MCP que conecta o Cline a um sistema de agentes de IA, permitindo interação perfeita com agentes de IA através do Model Context Protocol.

Recursos

• 🚀 Enviar Mensagens: Envie mensagens para agentes de IA dentro de uma sessão.
• 💡 Gerenciamento de Sessões: Limpe sessões e inicie novas.
• 🔧 Gerenciamento de Assistentes: Obtenha uma lista de assistentes disponíveis e altere o assistente de uma sessão.

Início Rápido

Instalar via npm (Recomendado)

npm install -g @avi/mcp-ai-agent-server

Instalar via npx (Sem necessidade de instalação)

npx @avi/mcp-ai-agent-server

Configuração

Para Cline

Adicione ao arquivo de configurações MCP do Cline:

Localização:

• macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Configuração:

{
  "mcpServers": {
    "ai-agent-mcp": {
      "command": "npx",
      "args": ["@avi/mcp-ai-agent-server"],
      "env": {
        "AI_AGENT_API_KEY": "your-api-key-here",
        "AI_AGENT_BASE_URL": "http://localhost:3000"
      }
    }
  }
}

Ferramentas Disponíveis

send_message

Envie uma mensagem em uma sessão com anexos opcionais.

Parâmetros:

• messageContent (obrigatório): O conteúdo da mensagem a ser enviada.
• attachments (opcional): Um array de anexos de arquivos.

Exemplo:

"Can you use send_message to say 'hello'?"

get_session

Obtenha ou crie uma sessão.

Parâmetros:

• Nenhum

Exemplo:

"Get the current session."

clear_session

Limpe a sessão atual e inicie uma nova.

Parâmetros:

• Nenhum

Exemplo:

"Please clear the session."

get_assistants

Obtenha uma lista de assistentes disponíveis.

Parâmetros:

• Nenhum

Exemplo:

"List the available assistants."

change_assistant

Altere o assistente de uma sessão.

Parâmetros:

• sessionId (obrigatório): O ID da sessão a ser atualizada.
• newAssistantId (obrigatório): O ID do novo assistente.

Exemplo:

"Change the assistant for the current session to 'assistant-2'."

Variáveis de Ambiente

Variável	Descrição	Obrigatória	Padrão
AI_AGENT_API_KEY	Chave de API para autenticação	Sim	-
AI_AGENT_BASE_URL	Endpoint de API personalizado para o sistema de agentes de IA	Não	http://localhost:3000

Solução de Problemas

Operação Excedeu o Tempo Limite

Se você encontrar um erro de "Operation timed out", isso significa que a solicitação ao serviço de agentes de IA está demorando mais do que o tempo limite interno padrão do servidor. Você pode resolver isso aumentando o valor de timeout nas configurações MCP do Cline:

{
  "mcpServers": {
    "ai-agent-mcp": {
      "command": "npx",
      "args": ["@avi/mcp-ai-agent-server"],
      "timeout": 300000, // 5 minutes
      "env": {
        "AI_AGENT_API_KEY": "your-api-key-here",
        "AI_AGENT_BASE_URL": "http://localhost:3000"
      }
    }
  }
}

Desenvolvimento

Compilar a partir do código-fonte

git clone https://github.com/avi/mcp-ai-agent-server.git
cd mcp-ai-agent-server
npm install
npm run build

Testar localmente

# Using MCP Inspector
npx @modelcontextprotocol/inspector ./build/index.js

# Manual testing
AI_AGENT_API_KEY=test-key node ./build/index.js

Licença

MIT - Consulte LICENSE para obter detalhes.

Agradecimentos

Construído com o Model Context Protocol SDK