MCP AI Agent Server

An MCP server that bridges Cline to an AI agent system, allowing for seamless interaction with AI agents through the Model Context Protocol.

Features

• 🚀 Send Messages: Send messages to AI agents within a session.
• 💡 Session Management: Clear sessions and start new ones.
• 🔧 Assistant Management: Get a list of available assistants and change the assistant for a session.

Quick Start

Install via npm (Recommended)

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

Install via npx (No installation required)

npx @avi/mcp-ai-agent-server

Configuration

For Cline

Add to your Cline MCP settings file:

Location:

• 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`

Configuration:

{
  "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"
      }
    }
  }
}

Available Tools

`send_message`

Send a message in a session with optional attachments.

Parameters:

• `messageContent` (required): The message content to send.
• `attachments` (optional): An array of file attachments.

Example:

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

`get_session`

Get or create a session.

Parameters:

• None

Example:

"Get the current session."

`clear_session`

Clear the current session and start a new one.

Parameters:

• None

Example:

"Please clear the session."

`get_assistants`

Get a list of available assistants.

Parameters:

• None

Example:

"List the available assistants."

`change_assistant`

Change the assistant for a session.

Parameters:

• `sessionId` (required): The session ID to update.
• `newAssistantId` (required): The ID of the new assistant.

Example:

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

Environment Variables

Troubleshooting

Operation Timed Out

If you encounter an "Operation timed out" error, it means the request to the AI agent service is taking longer than the server's default internal timeout. You can resolve this by increasing the `timeout` value in your Cline MCP settings:

{
  "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"
      }
    }
  }
}

Development

Build from source

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

Testing locally

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

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

License

MIT - See LICENSE for details.

Acknowledgments

Built with the Model Context Protocol SDK