Ones Wiki Mcp Server
About
A Spring AI MCP-based service for retrieving ONES Wiki content and converting it to AI-friendly text format.
Details
- Author
- brianxiadong
- Downloads
- 136
- Categories
- Knowledge Base
Jump to
- ONES platform authentication support
- Automatic conversion from Wiki URLs to API endpoints
- Extracts and formats Wiki page content
- Outputs AI-friendly Markdown text
- Configuration via properties file, CLI, or environment variables
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Ones Wiki Mcp ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Build the project with Maven (mvn clean package), then configure authentication via application.properties, command-line arguments, or environment variables (ones.host, ones.email, ones.password). Add the server to your MCP client (e.g., Claude Desktop) using the packaged JAR and credentials. Provide a full Wiki page URL to retrieve the page’s content in Markdown.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"ones wiki mcp server": {
"ones-wiki": {
"command": "java",
"args": [
"-jar",
"--ones.host=your-ones-host.com",
"--ones.email=your-email@example.com",
"--ones.password=your-password",
"target/ones-wiki-mcp-server-0.0.1-SNAPSHOT.jar"
],
"env": {
"JAVA_OPTS": "-Xmx512m"
}
}
}
}
}McpServers
{
"ones-wiki": {
"command": "java",
"args": [
"-jar",
"--ones.host=your-ones-host.com",
"--ones.email=your-email@example.com",
"--ones.password=your-password",
"target/ones-wiki-mcp-server-0.0.1-SNAPSHOT.jar"
],
"env": {
"JAVA_OPTS": "-Xmx512m"
}
}
}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
mvn clean package
2. Configure Authentication
Option 1: Modify application.properties
Edit src/main/resources/application.properties:
ones.host=your-ones-host.com
ones.email=your-email@example.com
ones.password=your-password
Option 2: Use Command Line Arguments
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
Option 3: Use Environment Variables
export ONES_HOST=your-ones-host.com
export ONES_EMAIL=your-email@example.com
export ONES_PASSWORD=your-password
./start-mcp-server.sh
3. Configure in MCP Client
Add to Claude Desktop configuration file:
{
"mcpServers": {
"ones-wiki": {
"command": "java",
"args": [
"-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"
]
}
}
}
Usage
Get Wiki Content
Provide the complete Wiki page URL when using the tool:
Please get the content of this Wiki page: https://your-ones-host.com/wiki/#/team/TEAM_UUID/space/SPACE_UUID/page/PAGE_UUID
URL Format
Supported Wiki URL format:
https://{host}/wiki/#/team/{team_uuid}/space/{space_uuid}/page/{page_uuid}
Automatically converts to API endpoint:
https://{host}/wiki/api/wiki/team/{team_uuid}/online_page/{page_uuid}/content
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
src/main/java/org/springframework/ai/mcp/sample/server/
├── McpServerApplication.java # Main application
└── OnesWikiService.java # ONES Wiki service
Running Tests
mvn test
Building from Source
git clone https://github.com/your-username/ones-wiki-mcp-server.git
cd ones-wiki-mcp-server
mvn clean package
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')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request
License
Apache License 2.0
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
