📚 README for docs‑kilocode‑mcp Repository

1️⃣ Project Overview

docs-kilocode-mcp is a lightweight helper repository that demonstrates how to set up and manage Model‑Context‑Protocol (MCP) servers using simple JSON configuration.
The repository contains a single mcp_settings.json file that defines two MCP servers:

• n8n‑mcp – an n8n workflow runner
• searxng‑mcp – a self‑hosted search engine

These servers are designed to be run from the command line or within Docker containers, making them easy to integrate into CI/CD pipelines or local development environments.

Why MCP?
MCP provides a standardized way for applications to interact with external tools and services in a language‑agnostic, structured manner. By declaring servers in a JSON file, developers can spin up tooling with a single command and use the MCP client libraries to communicate with them.

---

2️⃣ File Structure

docs-kilocode-mcp/
├── mcp_settings.json      # MCP server definitions
└── README.md              # Documentation (you are reading it now)

---

3️⃣ mcp_settings.json – MCP Server Configuration

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["-y", "n8n-mcp@2.12.2"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true"
      },
      "disabled": true,
      "alwaysAllow": []
    },
    "searxng-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "--name", "searxng-mcp",
        "--network", "linuxserver",
        "-e", "SEARXNG_URL",
        "isokoliuk/mcp-searxng:latest"
      ],
      "env": {
        "SEARXNG_URL": "http://searxng:8080"
      }
    }
  }
}

3.1 n8n-mcp

• Purpose: Runs an n8n workflow server via npx.
• Command: npx -y n8n-mcp@2.12.2
• Environment: Uses stdio mode, suppresses console output, and logs only errors.
• Disabled by default: Set "disabled": true.
  Remove or set to false to enable.

3.2 searxng-mcp

• Purpose: Spins up a Docker container for the SearxNG search engine.
• Command: docker run -i --rm --name searxng-mcp --network linuxserver -e SEARXNG_URL isokoliuk/mcp-searxng:latest
• Environment: Sets SEARXNG_URL to the container’s internal address.

---

4️⃣ How to Use

1. Clone the Repository

   git clone https://github.com/your-org/docs-kilocode-mcp.git
   cd docs-kilocode-mcp

2. Enable the Server You Need
   Edit mcp_settings.json and set "disabled" to false for the desired server(s).

3. Start the Server
   Run the command specified under command and args.
   Example for n8n-mcp:

   npx -y n8n-mcp@2.12.2

   Example for searxng-mcp:

   docker run -i --rm --name searxng-mcp --network linuxserver -e SEARXNG_URL http://searxng:8080 isokoliuk/mcp-searxng:latest

4. Connect via MCP Client
   Use any MCP client library to talk to the running server.
   (Refer to the official MCP documentation for language‑specific SDKs.)

---

5️⃣ Troubleshooting

Issue	Symptom	Fix
npx fails	No network / npm not found	Ensure Node.js is installed; check proxy settings.
Docker container exits immediately	Missing SEARXNG_URL env	Verify Docker network linuxserver exists; ensure env variable is correct.
Server not reachable	Connection refused	Check port exposure; confirm server is running.

---

6️⃣ Contributing

Feel free to open PRs to:

• Add new MCP server definitions
• Improve documentation
• Update Docker images / n8n versions

All contributions should follow the existing JSON schema.

---

7️⃣ License

MIT License