MCP Server for ElevenLabs

# MCP Server for ElevenLabs A Model Context Protocol (MCP) server specifically designed for ElevenLabs conversational agents, providing tools for agents to interact with external services and perform various tasks. > **📋 Project Documentation**: This project has specific deployment requirements and structure decisions. See [PROJECT-STRUCTURE.md](./PROJECT-STRUCTURE.md) before making any changes. ## Features This MCP server provides the following tools: - **search_web**: Search the web for information - **get_weather**: Get current weather information for a location - **calculate**: Perform mathematical calculations - **create_sickleave**: Create a sick leave document for a patient ## Installation 1. Install dependencies: ```bash npm install ``` 2. Start the server: ```bash npm start ``` ## ElevenLabs Integration This server is specifically designed for ElevenLabs conversational agents. For detailed setup instructions, see [ELEVENLABS-INTEGRATION.md](./ELEVENLABS-INTEGRATION.md). **⚠️ IMPORTANT**: Before making any changes to this project, read [PROJECT-STRUCTURE.md](./PROJECT-STRUCTURE.md) for critical deployment requirements and lessons learned. ### Quick Start for ElevenLabs: ```bash npm start ``` Then add `http://localhost:3000/mcp` to your ElevenLabs agent's MCP server configuration. ## Usage ### Development Mode Run the server: ```bash npm start ``` ### Production Mode Run the server: ```bash npm start ``` ## Configuration The server can be configured by modifying the following: - **Server name and version**: Edit `elevenlabs-true-streamable.js` - **Tool implementations**: Edit `elevenlabs-true-streamable.js` - **Tool schemas**: Modify the schemas in `elevenlabs-true-streamable.js` > **Note**: This project uses a single-file approach for deployment reliability. All tools and schemas are hardcoded in the main server file. ## Adding New Tools To add a new tool: 1. Define the tool schema in `elevenlabs-true-streamable.js`: ```javascript { name: "new_tool", description: "Description of the new tool", inputSchema: { type: "object", properties: { parameter: { type: "string", description: "Description of the parameter" } }, required: ["parameter"] } } ``` 2. Implement the tool handler in `elevenlabs-true-streamable.js`: ```javascript async function handleNewTool(args) { // Your tool implementation here return { content: [ { type: "text", text: "Tool result", }, ], }; } ``` 3. Add the tool to the tools array and the handler to the switch statement in `elevenlabs-true-streamable.js` > **Note**: This project uses a single-file approach. All modifications should be made directly in `elevenlabs-true-streamable.js`. ```javascript case "new_tool": return await handleNewTool(args); ``` ## MCP Client Configuration To use this server with an MCP client, add the following configuration: ```json { "mcpServers": { "my-mcp-server": { "command": "node", "args": ["path/to/your/mcp-server/dist/index.js"], "env": {} } } } ``` ## Development ### Project Structure ``` src/ ├── index.ts # Main server entry point ├── tools.ts # Tool definitions and implementations └── types.ts # Type definitions (if needed) ``` ### Scripts - `npm run build`: Build the TypeScript code - `npm run dev`: Run in development mode with hot reloading - `npm start`: Run the built server - `npm test`: Run tests (when implemented) ## Dependencies - `@modelcontextprotocol/sdk`: MCP SDK for server implementation - `zod`: Schema validation and type safety - `typescript`: TypeScript compiler - `tsx`: TypeScript execution for development ## License MIT