@ada-mcp/mcp-server 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,63 @@
1
+ # @ada-mcp/mcp-server
2
+
3
+ ADA MCP server package that supports:
4
+
5
+ - Local stdio mode (default) for MCP hosts
6
+ - Remote HTTP mode (`server`) with API key authentication
7
+ - MCP **Streamable HTTP** on `POST|GET|DELETE /mcp` (same port as legacy REST), with optional SSE per MCP spec (`@modelcontextprotocol/sdk` transport)
8
+
9
+ ## Run with npx / pnpm dlx
10
+
11
+ ```bash
12
+ npx -y @ada-mcp/mcp-server
13
+ ```
14
+
15
+ ```bash
16
+ pnpm dlx @ada-mcp/mcp-server
17
+ ```
18
+
19
+ ## Cursor MCP config (local stdio)
20
+
21
+ ```json
22
+ {
23
+ "mcpServers": {
24
+ "ada-mcp": {
25
+ "command": "npx",
26
+ "args": ["-y", "@ada-mcp/mcp-server"]
27
+ }
28
+ }
29
+ }
30
+ ```
31
+
32
+ ## Remote mode
33
+
34
+ Set API key in environment variable first:
35
+
36
+ ```bash
37
+ export ADA_MCP_REMOTE_API_KEY=your_token
38
+ ```
39
+
40
+ Windows PowerShell:
41
+
42
+ ```powershell
43
+ $env:ADA_MCP_REMOTE_API_KEY="your_token"
44
+ ```
45
+
46
+ Then run:
47
+
48
+ ```bash
49
+ ada-mcp server --host=127.0.0.1 --port=8787 --allow-risky=true --risky-mode=whitelist --risky-commands=custom
50
+ ```
51
+
52
+ ### Streamable HTTP (`/mcp`)
53
+
54
+ - Endpoint: `http://<host>:<port>/mcp` — same API key headers as below (`x-api-key` or `Authorization: Bearer`).
55
+ - First request: `POST /mcp` with JSON-RPC `initialize` (no `Mcp-Session-Id`); server returns a session id in `Mcp-Session-Id` response header.
56
+ - Follow-up: `POST /mcp` with body + `Mcp-Session-Id`; for server-initiated streaming, open `GET /mcp` with `Accept: text/event-stream` and the same session header.
57
+ - Session teardown: `DELETE /mcp` with `Mcp-Session-Id`.
58
+
59
+ When listening on all interfaces (e.g. `--host=0.0.0.0`), set allowed Host headers to satisfy DNS rebinding checks:
60
+
61
+ ```bash
62
+ ada-mcp server --host=0.0.0.0 --port=8787 --api-key=your_token --allowed-hosts=localhost,127.0.0.1
63
+ ```