Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-invoices create an invoice for $500 from Acme Corp"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Hello world MCP server, structured just like mcp: McpServer from the official SDK, stdio/HTTP transports, and AWS Lambda deploy via the Serverless Framework. Also includes an invoices ("facturas") feature backed by DynamoDB, exposed both as MCP tools and as a REST API.
npm install
npm run buildRelated MCP server: docnova-mcp
npm run mcp — starts the server over stdio (tsx src/server.ts)
To connect it to Claude Code / Cursor, point the MCP client at the npx tsx src/server.ts command (or the compiled binary in dist/server.js after npm run build).
npm run mcp:httpMCP: http://localhost:8787/mcp
Health: http://localhost:8787/health
Invoices REST API: http://localhost:8787/invoices
Requires AWS credentials with access to the InvoicesTable DynamoDB table (see Invoices below). Set INVOICES_TABLE_NAME (and optionally AWS_REGION / DYNAMODB_ENDPOINT for DynamoDB Local) in your .env.
npm run deploy -- --stage dev
npm run deploy:remove -- --stage devThe deploy uses serverless-esbuild to bundle lambdas/handler.ts and exposes the MCP server through API Gateway (HTTP API). Once it finishes, serverless deploy prints the public URL (https://<id>.execute-api.<region>.amazonaws.com/mcp); add serverless-domain-manager and your own DNS config if you want a custom domain.
Script | Description |
| MCP over stdio (local) |
| MCP over HTTP (local) |
| Compiles |
| Type-checks without emitting |
| Lambda + API Gateway |
| Removes the deployed stack |
say_hello({ name? }) → returns Hello, <name>! (or Hello, world! if no name is given).
save_invoice({ invoiceNumber?, date, provider, concept, currency, amount, status?, items? }) → creates an invoice in DynamoDB.
get_invoice({ id }) → fetches a single invoice by id.
list_invoices({ from?, to?, limit?, cursor? }) → lists invoices sorted by date (newest first), optionally filtered by date range (YYYY-MM-DD).
Invoices are stored in a DynamoDB table (InvoicesTable, provisioned in serverless.yml) with id as the primary key and a byDate global secondary index for date-range queries.
Fields: id, invoiceNumber?, date (ISO YYYY-MM-DD), provider, concept, currency (default USD), amount, status (pending | paid, default pending), items? ({ description, quantity, unitPrice }[]), createdAt, updatedAt.
Method & path | Description |
| Create an invoice. Body matches the invoice fields above (minus |
| List invoices. Query params: |
| Fetch a single invoice, 404 if not found. |
No authentication yet — add it before exposing this outside a trusted network.
MCP client → src/server.ts (stdio) | src/index.ts / lambdas/handler.ts (HTTP) → src/register-server.ts → tools/
REST client → src/app.ts (Express) → src/routes/ → src/repositories/ → DynamoDBFile | Role |
| Factory that creates the |
| Stdio entrypoint (Cursor/Claude Code, local) |
| Express app with the Streamable HTTP transport ( |
| Local HTTP entrypoint ( |
|
|
| One |
| Express routers for the REST API |
| DynamoDB data access (shared by MCP tools and REST routes) |
| Zod schemas / types for domain entities |
| Shared |
This server cannot be deployed
Hosted MCP server for Mini Accountant: invoices, expenses, customers, analytics, tax estimates.
MCP server for Quaderno — tax-rate calculation, invoices, contacts, products, receipts & expenses.
MCP server for Codat — companies, connections, invoices, bills and financial statements.
Hosted MCP server for AWS cloud spend: service breakdowns, anomalies, savings and forecasts.
