home / mcp / ones wiki mcp server

ONES Wiki MCP Server

ones-wiki-mcp-server

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "brianxiadong-ones-wiki-mcp-server": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/ones-wiki-mcp-server-0.0.1-SNAPSHOT.jar",
        "--ones.host=your-ones-host.com",
        "[email protected]",
        "--ones.password=your-password"
      ],
      "env": {
        "ONES_HOST": "your-ones-host.com",
        "ONES_EMAIL": "[email protected]",
        "ONES_PASSWORD": "your-password"
      }
    }
  }
}

You can run the ONES Wiki MCP Server to fetch ONES Wiki pages and transform them into AI-friendly text for downstream processing. This server automates authentication, converts Wiki URLs to a usable API flow, and outputs clean, markdown-like text suitable for chat and analysis workflows.

How to use

Start the server locally and point your MCP client at the stdio-based process. You provide the complete Wiki page URL to fetch, and the server will retrieve content, convert it to a structured, AI-friendly Markdown-like format, and return it to your client.

How to install

Prerequisites you need before installing this server are Java 17 or higher and Maven 3.6 or higher, plus access to an ONES platform instance.

Step 1: Build the project

mvn clean package

Step 2: Run the server with authentication options

java -jar target/ones-wiki-mcp-server-0.0.1-SNAPSHOT.jar \
  --ones.host=your-ones-host.com \
  [email protected] \
  --ones.password=your-password

Step 3: Alternative authentication methods (optional)

# Use environment variables (example)
export ONES_HOST=your-ones-host.com
export [email protected]
export ONES_PASSWORD=your-password
./start-mcp-server.sh

Step 4: Configure the MCP client to use this server

{
  "mcpServers": {
    "ones_wiki": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/ones-wiki-mcp-server-0.0.1-SNAPSHOT.jar",
        "--ones.host=your-ones-host.com",
        "[email protected]",
        "--ones.password=your-password"
      ]
    }
  }
}

Additional setup and usage notes

The server supports authenticating with the ONES platform and HTTPS is supported for secure connections. It automatically handles ONES login, so you can rely on the provided credentials to access content.

Configuration and security

Configure credentials using environment variables or a properties file to keep secrets out of command history. Use HTTPS where possible to protect data in transit.

Troubleshooting

If authentication fails, verify that your host, email, and password are correct and reachable from the server. Check that the server process has network access to the ONES platform and that the host URL is correct.

Available tools

Extract and format Wiki content

Fetch a Wiki page HTML and convert it into a structured, AI-friendly Markdown-like text with headings, lists, tables, images descriptions, and links.

URL to API conversion

Automatically derive the API endpoint from a Wiki URL to fetch page content in a consistent format.

Authentication handling

Manage ONES platform login securely, with credentials supplied via environment variables or configuration files.