ones-wiki
ones-wiki-mcp-server
claude mcp add --transport stdio brianxiadong-ones-wiki-mcp-server java -jar /path/to/ones-wiki-mcp-server-0.0.1-SNAPSHOT.jar --ones.host=your-ones-host.com --ones.email=your-email@example.com --ones.password=your-password \ --env ONES_HOST="your-ones-host.com" \ --env ONES_EMAIL="your-email@example.com" \ --env ONES_PASSWORD="your-password"
How to use
ONES Wiki MCP Server is a Spring Boot-based service that authenticates to a ONES platform, fetches content from ONES Wiki, and converts HTML content into an AI-friendly Markdown format. It exposes a tool that, given a complete Wiki page URL, retrieves the page content via the converted API endpoint and returns structured text suitable for downstream AI processing. The server supports both programmatic configuration via a properties file or command line arguments, and can read credentials from environment variables for secure deployment. To use the server, configure your MCP client to point to the jar that runs with proper ONES host, email, and password, and then invoke the wiki page fetch operation by providing the full Wiki URL. The output will be a clean, Markdown-formatted representation of the wiki content, including headings, paragraphs, lists, tables, images, and links, while filtering out strikethrough content.
How to install
Prerequisites:
- Java 17 or higher
- Maven 3.6 or higher
- Access to a ONES platform instance
Installation steps:
- Ensure Java and Maven are installed:
- java -version
- mvn -version
- Clone the repository and build the project:
- git clone https://github.com/your-username/ones-wiki-mcp-server.git
- cd ones-wiki-mcp-server
- mvn clean package
- Run the MCP server:
- java -jar target/ones-wiki-mcp-server-0.0.1-SNAPSHOT.jar
--ones.host=your-ones-host.com
--ones.email=your-email@example.com
--ones.password=your-password
- java -jar target/ones-wiki-mcp-server-0.0.1-SNAPSHOT.jar
- Alternatively, use environment variables to supply credentials:
- export ONES_HOST=your-ones-host.com
- export ONES_EMAIL=your-email@example.com
- export ONES_PASSWORD=your-password
- java -jar target/ones-wiki-mcp-server-0.0.1-SNAPSHOT.jar
- If integrating via MCP client, configure the mcpServers entry as shown in mcp_config.
Additional notes
Tips and notes:
- Credentials can be supplied via command line, environment variables, or a properties file (preferred for production).
- The server converts wiki HTML to Markdown and supports headings, paragraphs, lists, tables (as key-values), images, and links. Strikethrough is filtered out.
- Ensure HTTPS is used for ONES endpoints when possible. The server handles login authentication automatically.
- You can extend functionality by modifying OnesWikiService.java to add more tools like search, directory structure retrieval, or batch processing.
- If the API endpoint or wiki URL formats change on ONES, update the URL builder logic in the service accordingly.
