Ones Wiki MCP Server

What brianxiadong/ones-wiki-mcp-server MCP server does

The brianxiadong/ones-wiki-mcp-server MCP server connects an MCP client to an ONES platform instance for Wiki page retrieval. Its documented use case is providing a complete ONES Wiki page URL and returning the page content in a format suitable for AI processing.

The service handles the conversion between the browser-facing Wiki URL and the ONES content API. For a URL containing a team UUID, space UUID, and page UUID, it constructs the corresponding endpoint under /wiki/api/wiki/team/{team_uuid}/online_page/{page_uuid}/content.

Returned HTML is converted into structured Markdown-like text. The conversion preserves heading levels from H1 through H6, paragraph text, ordered and unordered lists, table data represented as key-value information, image descriptions, and link information. Strikethrough content is filtered out.

How it works

The application is built with Spring Boot and Spring AI MCP support. It uses an HTTP client to communicate with ONES and Jsoup to parse the returned HTML. Authentication is handled through the configured ONES host, email address, and password, including the ONES platform login flow described by the project.

A typical request supplies a URL in this form:

https://{host}/wiki/#/team/{team_uuid}/space/{space_uuid}/page/{page_uuid}

The brianxiadong/ones-wiki-mcp-server MCP server then retrieves the page content and emits the converted result through its MCP service. The repository documents Claude Desktop configuration using a locally built Java archive.

Setup and configuration

The project requires Java 17 or newer and Maven 3.6 or newer. Build it from source with:

mvn clean package

Authentication and the ONES host can be supplied through Spring properties, command-line arguments, or environment variables. The documented environment variable names are ONES_HOST, ONES_EMAIL, and ONES_PASSWORD. The equivalent application properties are ones.host, ones.email, and ones.password.

For Claude Desktop, configure a Java command that runs the generated ones-wiki-mcp-server-0.0.1-SNAPSHOT.jar. Credentials may be passed as command-line properties, although the project notes that environment variables or configuration files are preferable for managing secrets. HTTPS connections are supported.

Tools and capabilities

The documented retrieval capability supports:

• Fetching an ONES Wiki page from its full Wiki URL
• Converting Wiki HTML into structured AI-readable text
• Preserving headings, paragraphs, lists, tables, images, and links
• Removing strikethrough content from the output
• Authenticating against an ONES platform instance

The repository mentions Wiki search, directory retrieval, and batch page processing as possible extensions, but does not document them as current capabilities.

Limitations and notes

The server depends on access to an ONES platform instance and requires valid ONES credentials. Requests should use the complete supported Wiki URL format; the material does not describe lookup by page title, search query, or page UUID alone.

The project is distributed as a Java application built with Maven rather than as a documented package-manager command. The available setup instructions build the JAR locally before configuring the MCP client. The README does not specify a hosted endpoint, a named MCP tool, or support for clients other than the Claude Desktop example.

The brianxiadong/ones-wiki-mcp-server MCP server is licensed under Apache License 2.0.