brianxiadong/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
1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')