merge upstream

.devcontainer/devcontainer.json

@@ -0,0 +1,34 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/microsoft/vscode-dev-containers/blob/main/containers/docker-from-docker-compose/.devcontainer/devcontainer.json
+{
+	"name": "MCPServer",
+	"dockerComposeFile": "docker-compose-local.yml",
+	"service": "mcp-server",
+	"runServices": ["mcp-server","db"],
+
+	"workspaceFolder": "/modelcontextprotocol/servers",
+
+	// Set *default* container specific settings.json values on container create.
+	"customizations": {
+			// Configure properties specific to VS Code.
+			"vscode": {
+					// Add the IDs of extensions you want installed when the container is created.
+					"extensions": [
+							"dbaeumer.vscode-eslint",
+							"ms-azuretools.vscode-docker"
+					]
+			}
+	},
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	//"forwardPorts": [3000],
+
+	// "mounts": [
+	//      "source=/etc/hosts,target=/etc/hosts,type=bind,consistency=cached"
+	//   ]
+	// Use 'postCreateCommand' to run commands after the container is created.
+	"postCreateCommand": "apt update && apt install -y git postgresql-client docker.io",
+
+	// Comment out to connect as root instead.
+	"remoteUser": "root"
+}

.devcontainer/docker-compose-local.yml

@@ -0,0 +1,24 @@
+version: '3.7'
+
+services:
+  mcp-server:
+    image: "node:22"
+    #command: ["host.docker.internal:1521/freepdb1"]
+    #build:
+    #  context: ..
+    #  dockerfile: src/oracle/Dockerfile
+    #  platforms:
+    #    - "linux/arm64"
+    command: tail -f /dev/null
+    environment:
+      - ORACLE_USER=hr
+      - ORACLE_PASSWORD=hr_2025
+    volumes:
+      - ..:/modelcontextprotocol/servers
+      - /var/run/docker.sock:/var/run/docker.sock
+  db:
+    image: postgres:latest
+    environment:
+      POSTGRES_USER: hr
+      POSTGRES_PASSWORD: hr_2025
+      POSTGRES_DB: hr

.gemini/styleguide.md

@@ -0,0 +1 @@
+../.github/copilot-instructions.md

.github/copilot-instructions.md

@@ -0,0 +1,122 @@
+---
+description: A Model Context Protocol server that provides read-only access to Oracle, MySQL, PostgreSQL, QNAP NAS and MikroTik RouterOS
+applyTo: "src/{oracle,mysql,postgres,qnap,mikrotik}/**"
+---
+# AI Agent Project Instructions: MCP Servers
+
+## Overview
+This project is part of a modular AI Agent system, with each module providing a specific capability. The `src/` directory implements various MCP servers, enabling the AI Agent to interact with databases (Oracle, MySQL, PostgreSQL), storage (QNAP NAS), and network devices (MikroTik RouterOS).
+
+## Technology Stack
+
+- **Programming Language:** TypeScript (Node.js)
+- **Package Management:** npm (Node Package Manager)
+- **Build System:** TypeScript compiler (`tsc`)
+- **Containerization:** Docker (see `Dockerfile`)
+- **Configuration:** Project-specific configuration files (e.g., `tsconfig.json`, `package.json`, `server.json`)
+
+## TypeScript Guidelines
+- Use TypeScript for all new code
+- Follow functional programming principles where possible
+- Use interfaces for data structures and type definitions
+- Prefer immutable data (const, readonly)
+- Use optional chaining (?.) and nullish coalescing (??) operators
+
+### Key Files
+
+#### Oracle Server (`src/oracle/`)
+- `index.ts`: Main entry point for the Oracle server logic
+- `server.ts`: Server initialization and MCP protocol setup
+- `db.ts`: Database connection and query execution logic
+- `handlers.ts`: Request handlers for tools and resources
+- `tools.ts`: Tool definitions (query, explain, stats, connect, awr)
+- `tools/`: Individual tool implementations
+
+#### MySQL Server (`src/mysql/`)
+- `index.ts`: Main entry point for the MySQL server logic
+- `server.ts`: Server initialization and MCP protocol setup
+- `db.ts`: Database connection and query execution logic
+- `handlers.ts`: Request handlers for tools and resources
+- `tools.ts`: Tool definitions (mysql-query, mysql-explain, mysql-stats, mysql-connect, mysql-awr)
+- `tools/`: Individual tool implementations
+
+#### PostgreSQL Server (`src/postgres/`)
+- `index.ts`: Main entry point for the PostgreSQL server logic
+- `server.ts`: Server initialization and MCP protocol setup
+- `db.ts`: Database connection and query execution logic
+- `handlers.ts`: Request handlers for tools and resources
+- `tools.ts`: Tool definitions (pg-query, pg-explain, pg-stats, pg-connect, pg-awr)
+- `tools/`: Individual tool implementations
+
+#### QNAP Server (`src/qnap/`)
+- `index.ts`: Main entry point for the QNAP server logic
+- `server.ts`: Server initialization and MCP protocol setup
+- `handlers.ts`: Request handlers for tools and resources
+- `tools.ts`: Tool definitions (qnap-connect, qnap-report, qnap-dir, qnap-file-info)
+- `tools/`: Individual tool implementations
+
+#### MikroTik Server (`src/mikrotik/`)
+- `index.ts`: Main entry point for the MikroTik server logic
+- `server.ts`: Server initialization and MCP protocol setup
+- `handlers.ts`: Request handlers for tools and resources
+- `tools.ts`: Tool definitions (mk-connect, mk-report, mk-get, mk-awr)
+- `tools/`: Individual tool implementations
+
+## How It Works
+- The servers are written in TypeScript and are designed to be run as Node.js applications.
+- They can be built and run locally or inside a Docker container for deployment.
+- Each server uses the Model Context Protocol (MCP) to expose tools and resources to AI Agents.
+
+## Development Workflow
+1. **Install Dependencies:**
+   ```sh
+   cd src/[module]
+   npm install
+   ```
+2. **Build the Project:**
+   ```sh
+   npm run build
+   ```
+3. **Run the Server (Locally):**
+   ```sh
+   npx -y @marcelo-ochoa/server-oracle localhost:1521/freepdb1
+   npx -y @marcelo-ochoa/server-mysql localhost:3306/mydb
+   npx -y @marcelo-ochoa/server-postgres localhost:5432/postgres
+   npx -y @marcelo-ochoa/server-qnap http://nas-ip:8080
+   npx -y @marcelo-ochoa/server-mikrotik 192.168.88.1
+   ```
+4. **Build with Docker:**
+   Build the Docker image and run the container:
+   ```sh
+   docker build -t mochoa/mcp-oracle -f src/oracle/Dockerfile .
+   docker build -t mochoa/mcp-mysql -f src/mysql/Dockerfile .
+   docker build -t mochoa/mcp-postgres -f src/postgres/Dockerfile .
+   docker build -t mochoa/mcp-qnap -f src/qnap/Dockerfile .
+   docker build -t mochoa/mcp-mikrotik -f src/mikrotik/Dockerfile .
+   ```
+5. **Publish to ModelContextProtocol:**
+   ```sh
+   mcp-publisher login github
+   mcp-publisher publish
+   ```
+6. **Publish to npm:**
+   ```sh
+   npm login
+   npm publish
+   ```
+7. **Test with Antigravity Code Editor:**
+   Build with Docker as is described in step 4.
+   ```sh
+   docker build -t mochoa/mcp-oracle -f src/oracle/Dockerfile .
+   # manually wait until user reloads MCP servers
+   ```
+   If antigravity is running, MCP Servers need to be reloaded.
+
+## Notes
+- Ensure you have Node.js and npm installed for local development.
+- For Docker-based workflows, ensure Docker is installed and running.
+- Each server may require specific environment variables for credentials (e.g., `QNAP_USER`, `MK_PASSWORD`, `PG_PASSWORD`).
+
+## Additional Resources
+- See the `README.md` in each module directory for specific usage, configuration, and advanced options.
+- Refer to the root project `README.md` for information about the overall system.

.github/workflows/docker-image.yml

@@ -0,0 +1,62 @@
+name: ci
+
+on:
+  push:
+    branches:
+      - "main"
+
+jobs:
+  docker:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+      - name: Build and push oracle
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: ./src/oracle/Dockerfile
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: mochoa/mcp-oracle:latest
+      - name: Build and push postgres
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: ./src/postgres/Dockerfile
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: mochoa/mcp-postgres:latest
+      - name: Build and push mysql
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: ./src/mysql/Dockerfile
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: mochoa/mcp-mysql:latest
+      - name: Build and push Mikrotik
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: ./src/mikrotik/Dockerfile
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: mochoa/mcp-mikrotik:latest
+      - name: Build and push QNAP
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: ./src/qnap/Dockerfile
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: mochoa/mcp-qnap:latest

.gitignore

@@ -303,3 +303,7 @@ cython_debug/
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 #.idea/
 .claude/settings.local.json
+
+# mcp-publisher
+.mcpregistry_github_token
+.mcpregistry_registry_token