Files · Cohere MCP Server for SMB Research and Summarization
67 (1 binary, 602.7 kB total)attempt 1
README.md·1959 B·markdown
markdown
# Cohere MCP Server for SMB Research and Summarization
> Expose Cohere's language models and search tools to AI agents via an MCP server, enabling automated research, summarization, and content generation for SMBs.
An MCP server built with `@reaatech/mcp-server-engine` and Express that wraps Cohere's chat/summarization APIs and Tavily's search/extract/crawl APIs as MCP tools. Provides auth, rate limiting, OpenTelemetry observability, and dual-transport (Streamable HTTP + SSE) support.
## Prerequisites
- **Cohere API key**: Get one at https://dashboard.cohere.com/api-keys
- **Tavily API key**: Get one at https://tavily.com
## Quick Start
```bash
# Install dependencies
pnpm install
# Copy and fill in environment variables
cp .env.example .env
# Start the MCP server
pnpm dev
```
The server listens on `http://localhost:8080`. Health endpoint at `GET /health`. MCP endpoint at `POST /mcp`.
## Available MCP Tools
| Tool Name | Description | Required Inputs |
|-----------|-------------|----------------|
| `summarize` | Summarize text using Cohere | `text` |
| `chat` | Chat with Cohere language model | `message` |
| `search-web` | Search the web via Tavily | `query` |
| `extract` | Extract raw content from URLs via Tavily | `urls` |
| `crawl` | Crawl a website via Tavily | `url` |
| `generate-report` | Research topic via Tavily + Cohere synthesis | `topic` |
| `parse-document` | Extract text from a Base64-encoded PDF | `content` |
Built-in tools from `@reaatech/mcp-server-tools`: `echo` and `health-check`.
## Architecture
Express 5 server with middleware pipeline: Auth → Rate Limit → Idempotency → Sanitization. Tools in `src/tools/` auto-discovered via `@reaatech/mcp-server-tools`. Cohere + Tavily client wrappers in `src/lib/`. OpenTelemetry observability via `@reaatech/mcp-server-observability`.
## Testing
```bash
pnpm test
```
Runs vitest with coverage reporting.
## License
MIT — see [LICENSE](./LICENSE).