Converts Wiki page HTML content to structured Markdown format for AI-friendly text output
Provides a framework for building the MCP server application, using Spring AI MCP for protocol support
Powers the application infrastructure of the MCP server, enabling configuration via properties, environment variables, and command-line arguments
ONES Wiki MCP Server
A Spring AI MCP-based service for retrieving ONES Wiki content and converting it to AI-friendly text format.
Features
š ONES platform authentication support
š Automatic conversion from Wiki URLs to API endpoints
š Extract and format Wiki page content
š¤ AI-friendly text output format
āļø Configuration via properties file or command line arguments
Prerequisites
Java 17 or higher
Maven 3.6 or higher
Access to a ONES platform instance
Quick Start
1. Build the Project
2. Configure Authentication
Option 1: Modify application.properties
Edit src/main/resources/application.properties
:
Option 2: Use Command Line Arguments
Option 3: Use Environment Variables
3. Configure in MCP Client
Add to Claude Desktop configuration file:
Usage
Get Wiki Content
Provide the complete Wiki page URL when using the tool:
URL Format
Supported Wiki URL format:
Automatically converts to API endpoint:
Output Format
The service converts Wiki page HTML content to structured Markdown format, including:
ā Heading levels (H1-H6)
ā Paragraph text
ā Ordered and unordered lists
ā Table data (key-value format)
ā Image descriptions
ā Link information
ā Strikethrough content (automatically filtered)
Technical Architecture
Spring Boot 3.4.5 - Application framework
Spring AI MCP - MCP protocol support
Jsoup 1.17.2 - HTML parsing
RestClient - HTTP client
Security Notes
Authentication credentials should be managed via environment variables or configuration files
HTTPS connections supported
Automatic handling of ONES platform login authentication
Development
Project Structure
Running Tests
Building from Source
Extending Functionality
You can add more tool methods to OnesWikiService
, such as:
Search Wiki pages
Get Wiki directory structure
Batch process multiple pages
Contributing
Fork the repository
Create a feature branch (
git checkout -b feature/amazing-feature
)Commit your changes (
git commit -m 'Add some amazing feature'
)Push to the branch (
git push origin feature/amazing-feature
)Open a Pull Request
License
Apache License 2.0
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
ones-wiki-mcp-server
Related MCP Servers
- MIT License
- MIT License
- AGPL 3.0
- MIT License