docbot-mcp 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.0.1] - 2026-03-07
+### Changed
+- Migrate from stdio to HTTP transport
+
+## [1.0.0] - 2026-03-05
+### Added
+- Initial release
+- `csvToJson` — converts CSV string to JSON array
+- `jsonToCsv` — converts JSON array to CSV string
+- `jsonToMarkdown` — converts JSON array to Markdown table
+- `csvToMarkdown` — converts CSV string to Markdown table

package/README.md

@@ -0,0 +1,177 @@
+# docbot-mcp
+
+Bidirectional CSV ↔️ JSON ↔️ Markdown transformer exposed as an MCP (Model Context Protocol) server with HTTP transport.
+
+## Overview
+
+**docbot-mcp** is a Model Context Protocol server that provides tools for converting between CSV, JSON, and Markdown formats. It's built on the [Model Context Protocol](https://modelcontextprotocol.io/) and designed for deployment on serverless platforms like AWS App Runner.
+
+## Features
+
+- ✅ **CSV to JSON** — Parse CSV strings into JSON arrays
+- ✅ **JSON to CSV** — Serialize JSON arrays to CSV format
+- ✅ **CSV to Markdown** — Convert CSV to formatted Markdown tables
+- ✅ **JSON to Markdown** — Convert JSON arrays to Markdown tables
+- ✅ **HTTP-based** — REST API endpoint for easy integration
+- ✅ **Containerized** — Ready for deployment on AWS App Runner, Docker, etc.
+
+## Installation
+
+```bash
+npm install
+```
+
+### Requirements
+
+- Node.js 16+ (ES modules support)
+- Dependencies:
+  - `@modelcontextprotocol/sdk` — MCP protocol implementation
+  - `@rflukerii/docbot` — Document conversion utilities
+  - `express` — HTTP server framework
+  - `zod` — Input validation
+
+## Usage
+
+### Starting the Server
+
+```bash
+npm start
+```
+
+The server starts on `http://localhost:3000` with the MCP endpoint at `/docbot-mcp`.
+
+### Available Tools
+
+All tools accept input as text parameters and return formatted text responses.
+
+#### csvToJson
+Converts a CSV string to JSON format.
+
+**Input:** `csv` (string)  
+**Output:** JSON array as string
+
+```bash
+curl -X POST http://localhost:3000/docbot-mcp \
+  -H "Content-Type: application/json" \
+  -d '{"tool": "csvToJson", "input": {"csv": "name,age\nAlice,30"}}'
+```
+
+#### jsonToCsv
+Converts a JSON array to CSV format.
+
+**Input:** `json` (string)  
+**Output:** CSV string
+
+```bash
+curl -X POST http://localhost:3000/docbot-mcp \
+  -H "Content-Type: application/json" \
+  -d '{"tool": "jsonToCsv", "input": {"json": "[{\"name\":\"Alice\",\"age\":30}]"}}'
+```
+
+#### csvToMarkdown
+Converts a CSV string to a Markdown table.
+
+**Input:** `csv` (string)  
+**Output:** Markdown table string
+
+#### jsonToMarkdown
+Converts a JSON array to a Markdown table.
+
+**Input:** `json` (string)  
+**Output:** Markdown table string
+
+## Architecture
+
+### HTTP Transport
+
+The server uses `StreamableHTTPServerTransport` instead of stdio for better compatibility with containerized environments. Each request to `/docbot-mcp` creates a new server instance, processes the MCP request, and returns the result.
+
+```
+Express Server (port 3000)
+    ↓
+POST /docbot-mcp endpoint
+    ↓
+MCP Server instance (createServer)
+    ↓
+StreamableHTTPServerTransport
+    ↓
+Tool execution (csvToJson, jsonToCsv, etc.)
+    ↓
+Response back to client
+```
+
+### File Structure
+
+- `index.js` — Main HTTP server entry point (AWS App Runner compatible)
+- `index-stdio.js` — Stdio transport version (for local/stdio-based clients)
+- `package.json` — Dependencies and scripts
+
+## Deployment
+
+### AWS App Runner
+
+The server includes a `start` script configured for AWS App Runner:
+
+```json
+{
+  "scripts": {
+    "start": "node index.js"
+  }
+}
+```
+
+**Steps to deploy:**
+
+1. Push code to AWS CodeCommit, GitHub, or BitBucket
+2. Create AWS App Runner service
+3. Configure source as your repository
+4. Set build command: `npm install`
+5. Set start command: `npm start`
+6. App Runner will automatically run the server on port 3000
+
+### Docker
+
+Example Dockerfile:
+
+```dockerfile
+FROM node:18-alpine
+WORKDIR /app
+COPY package*.json ./
+RUN npm install --production
+COPY . .
+EXPOSE 3000
+CMD ["npm", "start"]
+```
+
+## Development
+
+### Switching Between Transports
+
+- **HTTP (default)**: `node index.js` — For containerized environments
+- **Stdio**: `node index-stdio.js` — For direct CLI/stdio clients
+
+### Adding New Tools
+
+Edit `index.js` and use the `server.registerTool()` pattern:
+
+```javascript
+server.registerTool(
+  'toolName',
+  {
+    title: 'Display Title',
+    description: 'What it does',
+    inputSchema: { paramName: z.type() }
+  },
+  async ({ paramName }) => ({
+    content: [{ type: 'text', text: 'result' }]
+  })
+);
+```
+
+## License
+
+MIT
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for version history and updates.

package/index-stdio.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+
+// External imports
+import { csvToJson, jsonToCsv, jsonToMarkdown, csvToMarkdown } from '@rflukerii/docbot'
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+
+const server = new McpServer({
+  name: 'docbot-mcp',
+  version: '1.0.0'
+});
+
+server.registerTool(
+  'csvToJson',
+  {
+    title: 'Convert CSV to JSON',
+    description: 'Converts a CSV string to JSON',
+    inputSchema: { csv: z.string() }
+  },
+  async ({ csv }) => ({
+    content: [{ type: 'text', text: JSON.stringify(csvToJson(csv)) }]
+  })
+);
+
+server.registerTool(
+  'jsonToCsv',
+  {
+    title: 'Convert JSON to CSV',
+    description: 'Converts a JSON string to CSV',
+    inputSchema: { json: z.string() }
+  },
+  async ({ json }) => ({
+    content: [{ type: 'text', text: jsonToCsv(JSON.parse(json)) }]
+  })
+);
+
+server.registerTool(
+  'csvToMarkdown',
+  {
+    title: 'Convert CSV to Markdown',
+    description: 'Converts a CSV string to Markdown',
+    inputSchema: { csv: z.string() }
+  },
+  async ({ csv }) => ({
+    content: [{ type: 'text', text: csvToMarkdown(csv) }]
+  })
+);
+
+server.registerTool(
+  'jsonToMarkdown',
+  {
+    title: 'Convert JSON to Markdown',
+    description: 'Converts a JSON string to Markdown',
+    inputSchema: { json: z.string() }
+  },
+  async ({ json }) => ({
+    content: [{ type: 'text', text: jsonToMarkdown(JSON.parse(json)) }]
+  })
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/index.js

@@ -1,63 +1,85 @@
-#!/usr/bin/env node
-
-// External imports
-import { csvToJson, jsonToCsv, jsonToMarkdown, csvToMarkdown } from '@rflukerii/docbot'
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { z } from 'zod';
-
-const server = new McpServer({
-  name: 'docbot-mcp',
-  version: '1.0.0'
-});
-
-server.registerTool(
-  'csvToJson',
-  {
-    title: 'Convert CSV to JSON',
-    description: 'Converts a CSV string to JSON',
-    inputSchema: { csv: z.string() }
-  },
-  async ({ csv }) => ({
-    content: [{ type: 'text', text: JSON.stringify(csvToJson(csv)) }]
-  })
-);
-
-server.registerTool(
-  'jsonToCsv',
-  {
-    title: 'Convert JSON to CSV',
-    description: 'Converts a JSON string to CSV',
-    inputSchema: { json: z.string() }
-  },
-  async ({ json }) => ({
-    content: [{ type: 'text', text: jsonToCsv(JSON.parse(json)) }]
-  })
-);
-
-server.registerTool(
-  'csvToMarkdown',
-  {
-    title: 'Convert CSV to Markdown',
-    description: 'Converts a CSV string to Markdown',
-    inputSchema: { csv: z.string() }
-  },
-  async ({ csv }) => ({
-    content: [{ type: 'text', text: csvToMarkdown(csv) }]
-  })
-);
-
-server.registerTool(
-  'jsonToMarkdown',
-  {
-    title: 'Convert JSON to Markdown',
-    description: 'Converts a JSON string to Markdown',
-    inputSchema: { json: z.string() }
-  },
-  async ({ json }) => ({
-    content: [{ type: 'text', text: jsonToMarkdown(JSON.parse(json)) }]
-  })
-);
-
-const transport = new StdioServerTransport();
-await server.connect(transport);
+#!/usr/bin/env node
+
+// External imports
+import { csvToJson, jsonToCsv, jsonToMarkdown, csvToMarkdown } from '@rflukerii/docbot'
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { z } from 'zod';
+import express from 'express';
+
+const app = express();
+app.use(express.json());
+
+function createServer() {
+  const server = new McpServer({
+    name: 'docbot-mcp',
+    version: '1.0.0'
+  });
+
+  server.registerTool(
+    'csvToJson',
+    {
+      title: 'Convert CSV to JSON',
+      description: 'Converts a CSV string to JSON',
+      inputSchema: { csv: z.string() }
+    },
+    async ({ csv }) => ({
+      content: [{ type: 'text', text: JSON.stringify(csvToJson(csv)) }]
+    })
+  );
+
+  server.registerTool(
+    'jsonToCsv',
+    {
+      title: 'Convert JSON to CSV',
+      description: 'Converts a JSON string to CSV',
+      inputSchema: { json: z.string() }
+    },
+    async ({ json }) => ({
+      content: [{ type: 'text', text: jsonToCsv(JSON.parse(json)) }]
+    })
+  );
+
+  server.registerTool(
+    'csvToMarkdown',
+    {
+      title: 'Convert CSV to Markdown',
+      description: 'Converts a CSV string to Markdown',
+      inputSchema: { csv: z.string() }
+    },
+    async ({ csv }) => ({
+      content: [{ type: 'text', text: csvToMarkdown(csv) }]
+    })
+  );
+
+  server.registerTool(
+    'jsonToMarkdown',
+    {
+      title: 'Convert JSON to Markdown',
+      description: 'Converts a JSON string to Markdown',
+      inputSchema: { json: z.string() }
+    },
+    async ({ json }) => ({
+      content: [{ type: 'text', text: jsonToMarkdown(JSON.parse(json)) }]
+    })
+  );
+
+  return server;
+}
+
+app.get('/health', (req, res) => {
+  res.status(200).send('OK');
+});
+
+app.post('/docbot-mcp', async (req, res) => {
+  const server = createServer();
+  const transport = new StreamableHTTPServerTransport({
+    sessionIdGenerator: undefined,
+  });
+  await server.connect(transport);
+  await transport.handleRequest(req, res, req.body);
+});
+
+app.listen(process.env.PORT || 3000, () => {
+  console.log('docbot-mcp running on http://localhost:3000/docbot-mcp');
+});

package/package.json

@@ -1,19 +1,22 @@
 {
   "name": "docbot-mcp",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Bidirectional CSV <> JSON <> Markdown transformer",
   "main": "index.js",
   "bin": {
     "docbot-mcp": "./index.js"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "start": "node index.js"
   },
   "author": "",
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "@rflukerii/docbot": "^1.0.1"
+    "@rflukerii/docbot": "^1.0.1",
+    "express": "^5.2.1",
+    "zod": "^4.3.6"
   },
   "type": "module"
 }