chore: @modelcontextprotocol/sdk als Abhängigkeit hinzugefügt

README.md

@@ -0,0 +1,99 @@
+# Search Agent
+
+An intelligent search service with REST API, CLI, and MCP server interfaces.
+
+## Features
+
+- **REST API**: Full-featured HTTP API with streaming support
+- **CLI**: Command-line interface for quick searches
+- **MCP Server**: Model Context Protocol server for integration with AI assistants
+
+## Installation
+
+```bash
+npm install
+```
+
+## Usage
+
+### REST API Server
+
+```bash
+npm run serve
+```
+
+The server will start at `http://localhost:3000`.
+
+### CLI
+
+```bash
+npm run search "Your question here"
+```
+
+### MCP Server
+
+```bash
+npm run mcp
+```
+
+## MCP Configuration
+
+To use the search agent as an MCP server in your AI assistant, add this to your configuration:
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "search-agent": {
+      "command": "node",
+      "args": ["/path/to/searchAgent/mcpServer.js"],
+      "env": {
+        "EXA_API_KEY": "your-exa-api-key",
+        "OPENROUTER_API_KEY": "your-openrouter-api-key"
+      }
+    }
+  }
+}
+```
+
+### Other MCP Clients
+
+For other MCP clients, configure the command as:
+- Command: `node`
+- Args: `["/path/to/searchAgent/mcpServer.js"]`
+- Environment variables: `EXA_API_KEY` and `OPENROUTER_API_KEY`
+
+## Available MCP Tools
+
+### search
+
+Search for information and return a summarized answer with sources.
+
+**Parameters:**
+- `question` (required): The question or topic to search for
+- `previousClarification` (optional): Previous clarification from the user if the question needed refinement
+- `originalQuestion` (optional): The original question if this is a follow-up
+
+**Example:**
+```json
+{
+  "name": "search",
+  "arguments": {
+    "question": "What are the latest developments in AI?"
+  }
+}
+```
+
+## Environment Variables
+
+Required:
+- `EXA_API_KEY`: Your Exa API key
+- `OPENROUTER_API_KEY`: Your OpenRouter API key
+
+Optional:
+- `PORT`: Port for REST server (default: 3000)
+- `HOST`: Host for REST server (default: 0.0.0.0)
+- `MAINTENANCE_MODE`: Set to "true" to enable maintenance mode