docbot-mcp 1.0.1 → 1.0.3

package/.github/copilot-instructions.md

@@ -0,0 +1,57 @@
+# GitHub Copilot Instructions for docbot-mcp
+
+## Purpose
+Provide workspace-specific guidance for Copilot Chat agents to work effectively in this small Node.js MCP server project.
+
+## Project brief
+- Node.js (ES modules, `type: module`) MCP server for CSV/JSON/Markdown conversion.
+- Two transports: HTTP (`index.js`) and stdio (`index-stdio.js`).
+- Minimal scripts (`npm start` for HTTP), no automated tests currently.
+- Dependencies: `@modelcontextprotocol/sdk`, `@rflukerii/docbot`, `express`, `zod`.
+
+## Key files
+- `index.js` : main server (HTTP + Express on port 3000, MCP tool registration)
+- `index-stdio.js` : stdio transport alternative
+- `README.md` : most up-to-date usage, architecture and examples
+- `package.json` : scripts + dependencies
+
+## Build / test commands
+- `npm install`
+- `npm start` (starts production-like server on localhost:3000)
+- `node index-stdio.js` (stdio transport)
+
+> Note: no test suite exists, implement new tests in a modern style (Jest/Mocha/Node test runner) if requested.
+
+## Architecture notes
+- Each POST to `/docbot-mcp` creates a new MCP server via `createServer` and `StreamableHTTPServerTransport`.
+- Tools are registered via `server.registerTool()` with Zod schema validation.
+- Conversion logic primarily lives in the `@rflukerii/docbot` package and is wrapped by MCP tool handlers.
+
+## Conventions / style
+- ES modules (`import` / `export`) throughout.
+- Keep payloads as text (`type: 'text'`, `content` array) in MCP responses.
+- Avoid mutating shared state; each request new server context.
+- For new tool additions, follow the registration pattern in `index.js`.
+
+## Common changes
+- Add tool: update `index.js` tool registry + README docs
+- Transport behavior: follow patterns for `StreamableHTTPServerTransport` and stdio setup
+
+## Gotchas
+- Do not use `require()` (Esm only).
+- Express v5 middleware and response flow must match existing behavior.
+- Keep `content` as string arrays; avoid mixing objects in response type unless MCP spec supports.
+
+## Example prompts
+1. "Add tool `yamlToJson` in `index.js` with schema `yaml: z.string()`, converting YAML text to JSON string output."
+2. "Refactor server lifecycle in `index.js` so MCP server instance is reused across requests but still isolates tool execution per request."
+3. "Add basic Jest tests for `csvToJson` and `jsonToCsv` using `node index-stdio.js` or direct function exports."
+
+## Next agent customizations
+- **agent**: `create-agent docbot-mcp/dev` (focus on tool authoring and transport patches).
+- **prompt**: `create-prompt docbot-mcp/add-tool` (guides on how to add tools with converters and Zod schemas).
+- **hook**: `create-hook docbot-mcp/on-run-tests` (automate test command from unobtrusive mode).
+
+---
+
+> This file is intended as workspace bootstrap for Copilot Chat. Keep it minimal, precise, and updated when major architecture or dependency changes occur.

package/.github/instructions/chat.instructions.md

@@ -0,0 +1,45 @@
+---
+name: chat-instructions
+description: Chatbot response rules and guidelines
+---
+
+# Chat Instructions
+
+These instructions govern how chatbots respond to user prompts. Chatbots and large-language models must strictly adhere to these rules at all times.
+
+**Rule 1: Always limit responses to a maximum of 30 words**
+
+**Rule 2: Chat in a conversational manner**
+
+A conversational manner means:
+
+- Use natural language that mimics human conversation
+- Write direct and concise statements or questions
+- Exchange back-and-forth dialogue addressing one idea or topic at a time
+- Avoid providing multiple suggestions, explanations, or solutions in a single response
+- When the user writes a declarative prompt:
+  - Do NOT immediately provide answers, suggestions or explanations
+  - Respond with a simple acknowledgement
+  - Ask a question to clarify intent--a declarative prompt may be a prelude to an imperative or interrogative prompt
+
+**Rule 3: Tutoring the User**
+
+When the user asks how to complete a complex procedure such as coding and developing a user-interface, adhere to the following rules:
+
+- **Do not immediately provide a full solution:**\
+Begin by framing the problem to help the user reason about the solution themselves.
+
+- **Surface initial thought starters:**\
+Share guiding principles or foundational concepts relevant to the task (e.g., componentization, data flow, layout hierarchy, state boundaries).
+
+- **Ask probing, clarifying questions:**\
+Use questions to uncover intent, constraints, and assumptions. The goal is to lead the user's thinking, not to guess on their behalf.
+
+- **Facilitate decomposition:**\
+Use chain-of-thought (CoT) reasoning to break down complex procedures into smaller, manageable steps and present each step sequentially. (e.g., pages → sections → components → behaviors).
+
+- **Use conversational scaffolding:**\
+Phrase guidance in a way that nudges the user toward the correct approach without asserting the solution. Avoid prescriptive language unless explicitly prompted.
+
+- **Casually confirm understanding:**\
+Periodically check the user's comprehension with a short quiz e.g. "Does this distinction make sense?" or "Can you explain why we'd lift this state?".

package/.github/instructions/version-control.instructions.md

@@ -0,0 +1,97 @@
+# Version Control Instructions
+
+Git is the version-control system used for this project.
+
+Follow the rules below when a user prompts you to complete a task related to version control.
+
+## Copilot Capabilities
+
+You are allowed to carry out ONLY the following two actions:
+
+1. Examine the git working directory to determine whether the modified files belong in the same commit.
+2. Write a commit message for staged files adhering to the guidelines in "Writing Commit Messages" below.
+
+### Allowed Commands
+
+Copilot may always run the following commands without asking for permission:
+
+- **git status --short**\
+List files that are in the working directory as well as files that are staged for commit.
+
+- **git diff --name-only**\
+List files in the working diretory that have unstaged changes.
+
+- **git diff --staged --name-only**\
+List files that are staged for commit.
+
+### Prohibited Commands
+
+Copilot is NEVER allowed to modify the index nor run the following commands regardless of user permission:
+
+- **git add [file]**\
+NEVER stage a file for commit.
+
+- **git commit -m "[message]"**\
+NEVER create a commit.
+
+- **git restore [file]**\
+NEVER discard changes in the working directory.
+
+- **git reset [file]**\
+NEVER unstage a file.
+
+- **git push**\
+NEVER push commits to a remote repository.
+
+- **git pull**\
+NEVER pull changes from a remote repository.
+
+
+- Always examine the diffs of staged files to get context for commit messages
+  - List staged files by executing `git diff --cached --name-only`
+  - View file diffs, run `git diff --cached`
+- If there are no staged files:
+  - Do not write a commit message
+  - Inform the user, "There are not staged files"
+
+## Writing Commit Messages
+
+Commit messages must follow the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) structure including:
+
+1. Use the imperative mood -- the message should complete the sentence: "If applied, this commit will __"
+2. Insert a blank line between the subject and the body
+3. Limit the subject to a maximum of 50 characters
+4. Wrap the body lines at approximately 72 characters
+5. Use Conventional Commit prefixes (e.g., `feat:`, `fix:`, `docs:`, `refactor`, `revert`)
+
+Carry out the following steps when prompted to write a commit message:
+
+1. Check for staged files: run `git diff --staged --name-only`
+2. If there are no staged files:
+   - Do not write a commit message
+   - Inform the user, "There are not staged files"
+
+If there are staged files:
+
+1. Run `git diff --staged` to examine the diffs and get context for commit messages
+2. Based on the file diffs, infer the message's structural elements including:
+   - Prefix
+   - Optional scope
+   - Body
+   - Footer
+3. Output the commit message inside the chat panel for the user to preview prior to commit
+
+### Example Message Structure
+
+```
+feat(auth): add OAuth2 provider for Google logins
+
+Implement the Google-specific strategy within the passport middleware.
+This allows users to authenticate using their corporate accounts.
+
+Fixes: #102
+```
+
+## References
+
+[Git documentation](https://git-scm.com/docs "Official Git docs")

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.0.3] - 2026-03-14
+### Changed
+- Update HTTP MCP endpoint from `/mcp` to `/docbot-mcp` for all incoming requests
+- Bump `server.json` package/service version to 1.0.3
+
+## [1.0.2] - 2026-03-09
+### Added
+- Add `mcpName` to package.json for MCP registry registration
+- Add `server.json` for MCP registry metadata
+
 ## [1.0.1] - 2026-03-07
 ### Changed
 - Migrate from stdio to HTTP transport

package/index-stdio.js

@@ -1,63 +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);
+#!/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,85 +1,121 @@
-#!/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');
+#!/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.2'
+  });
+
+  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)) + '\n\n@rflukerii/docubot'
+        },
+        {
+          type: 'text',
+          text: '@rflukerii/docubot'
+        }
+      ]
+    })
+  );
+
+  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)) + '\n\n@rflukerii/docubot'
+        },
+        {
+          type: 'text',
+          text: '@rflukerii/docubot' 
+        }
+      ]
+    })
+  );
+
+  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) + '\n\n@rflukerii/docubot'
+        },
+        {
+          type: 'text',
+          text: '@rflukerii/docubot' 
+        }
+      ]
+    })
+  );
+
+  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)) + '\n\n@rflukerii/docubot'
+        },
+        {
+          type: 'text',
+          text: '@rflukerii/docubot' 
+        }
+      ]
+    })
+  );
+
+  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,22 +1,23 @@
-{
-  "name": "docbot-mcp",
-  "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",
-    "start": "node index.js"
-  },
-  "author": "",
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "@rflukerii/docbot": "^1.0.1",
-    "express": "^5.2.1",
-    "zod": "^4.3.6"
-  },
-  "type": "module"
-}
+{
+  "name": "docbot-mcp",
+  "version": "1.0.3",
+  "mcpName": "io.github.rflukerii-dev/docbot-mcp",
+  "description": "Bidirectional CSV <> JSON <> Markdown transformer",
+  "main": "index.js",
+  "bin": {
+    "docbot-mcp": "./index.js"
+  },
+  "scripts": {
+    "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",
+    "express": "^5.2.1",
+    "zod": "^4.3.6"
+  },
+  "type": "module"
+}

package/sample_data.csv

@@ -0,0 +1,21 @@
+ID,First Name,Last Name,Email,Department,Job Title,Salary,Hire Date,Manager,Status
+1,John,Smith,john.smith@company.com,Engineering,Senior Developer,125000,2019-03-15,Alice Johnson,Active
+2,Sarah,Johnson,sarah.johnson@company.com,Marketing,Marketing Manager,95000,2020-06-20,Bob Wilson,Active
+3,Michael,Davis,michael.davis@company.com,Sales,Sales Executive,105000,2018-11-10,Carol White,Active
+4,Emily,Brown,emily.brown@company.com,HR,HR Specialist,72000,2021-01-25,David Green,Active
+5,David,Wilson,david.wilson@company.com,Engineering,Junior Developer,65000,2022-08-05,Alice Johnson,Active
+6,Jessica,Martinez,jessica.martinez@company.com,Finance,Finance Analyst,78000,2020-02-14,Edward Black,Active
+7,Robert,Anderson,robert.anderson@company.com,Operations,Operations Manager,98000,2019-09-30,Frank Gray,Active
+8,Lisa,Taylor,lisa.taylor@company.com,Marketing,Content Creator,68000,2021-04-12,Bob Wilson,Active
+9,James,Thomas,james.thomas@company.com,Sales,Sales Representative,72000,2021-11-08,Carol White,Active
+10,Patricia,Jackson,patricia.jackson@company.com,Engineering,DevOps Engineer,115000,2020-05-18,Alice Johnson,Active
+11,Christopher,White,christopher.white@company.com,Finance,Senior Accountant,92000,2019-07-22,Edward Black,Active
+12,Nancy,Harris,nancy.harris@company.com,HR,Recruiter,71000,2021-09-15,David Green,Active
+13,Daniel,Martin,daniel.martin@company.com,Operations,Logistics Coordinator,61000,2022-03-28,Frank Gray,Active
+14,Karen,Thompson,karen.thompson@company.com,Marketing,Social Media Manager,65000,2022-01-10,Bob Wilson,Active
+15,Paul,Garcia,paul.garcia@company.com,Sales,Account Executive,88000,2020-10-05,Carol White,Active
+16,Betty,Lee,betty.lee@company.com,Engineering,QA Engineer,82000,2021-06-14,Alice Johnson,Active
+17,Mark,Perez,mark.perez@company.com,Finance,Budget Analyst,75000,2021-12-06,Edward Black,Active
+18,Susan,Edwards,susan.edwards@company.com,HR,Training Manager,84000,2020-08-17,David Green,Active
+19,Donald,Collins,donald.collins@company.com,Operations,Supply Chain Manager,101000,2019-04-09,Frank Gray,Active
+20,Margaret,Stewart,margaret.stewart@company.com,Sales,Regional Manager,110000,2018-02-19,Carol White,Active

package/server.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.rflukerii-dev/docbot-mcp",
+  "description": "Bidirectional CSV <> JSON <> Markdown transformer",
+  "repository": {
+    "url": "https://github.com/rflukerii-dev/docbot-mcp",
+    "source": "github"
+  },
+  "version": "1.0.3",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "docbot-mcp",
+      "version": "1.0.3",
+      "transport": {
+        "type": "streamable-http"
+      }
+    }
+  ],
+  "remotes": {
+    "streamable-http": {
+      "url": "https://spdeyfjpfv.us-east-1.awsapprunner.com/docbot-mcp"
+    }
+  }
+}