ONES Wiki MCP Server
Spring AI MCP-based service for extracting and transforming ONES Wiki content for AI applications.
Key Features
Use Cases
README
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
- 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
Star History
Repository Owner
User
Repository Details
Programming Languages
Tags
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
@growi/mcp-server
Bridge GROWI wiki content to AI models with context-aware access and management.
@growi/mcp-server acts as a Model Context Protocol (MCP) server that enables AI models to access, search, and manage GROWI wiki content within an organization. It facilitates seamless connection between multiple GROWI instances and language models, enhancing information retrieval and knowledge management capabilities. The platform provides comprehensive tools for page, tag, comment, and revision management as well as share link and user activity tracking. Its flexible configuration allows simultaneous operation with several GROWI apps for scalable deployment.
- ⭐ 10
- MCP
- growilabs/growi-mcp-server
MCP Obsidian Server
Integrate Obsidian note management with AI models via the Model Context Protocol.
MCP Obsidian Server acts as a bridge between Obsidian and AI models by providing an MCP-compatible server interface. It enables programmatic access to Obsidian vaults through a local REST API, allowing operations like listing files, searching, reading, editing, and deleting notes. Designed to work with Claude Desktop and other MCP-enabled clients, it exposes a set of tools for efficient note and content management within Obsidian.
- ⭐ 2,394
- MCP
- MarkusPfundstein/mcp-obsidian
Notion MCP Server
Enable LLMs to interact with Notion using the Model Context Protocol.
Notion MCP Server allows large language models to interface with Notion workspaces through a Model Context Protocol server, supporting both data retrieval and editing capabilities. It includes experimental Markdown conversion to optimize token usage for more efficient communication with LLMs. The server can be configured with environment variables and controlled for specific tool access. Integration with applications like Claude Desktop is supported for seamless automation.
- ⭐ 834
- MCP
- suekou/mcp-notion-server
Yuque-MCP-Server
Seamless integration of Yuque knowledge base with Model-Context-Protocol for AI model context management.
Yuque-MCP-Server provides an MCP-compatible server for interacting with the Yuque knowledge base platform. It enables AI models to retrieve, manage, and analyze Yuque documents and user information through a standardized Model-Context-Protocol interface. The server supports operations such as document creation, reading, updating, deletion, advanced search, and team statistics retrieval, making it ideal for AI-powered workflows. Inspired by Figma-Context-MCP, it facilitates contextual awareness and dynamic knowledge management for AI applications.
- ⭐ 31
- MCP
- HenryHaoson/Yuque-MCP-Server
Confluence Communication Server MCP Server
Seamlessly interact with Confluence using standardized MCP tools.
Confluence Communication Server MCP Server is a TypeScript-based implementation that enables seamless interaction with Confluence through the Model Context Protocol. It provides tools for running CQL queries, retrieving, and updating Confluence page content, thus showcasing and adhering to core MCP concepts. The server is compatible with Claude Desktop and supports installation via Smithery, emphasizing ease of integration and automation for Confluence management tasks.
- ⭐ 13
- MCP
- KS-GEN-AI/confluence-mcp-server
Klavis
One MCP server for AI agents to handle thousands of tools.
Klavis provides an MCP (Model Context Protocol) server with over 100 prebuilt integrations for AI agents, enabling seamless connectivity with various tools and services. It offers both cloud-hosted and self-hosted deployment options and includes out-of-the-box OAuth support for secure authentication. Klavis is designed to act as an intelligent connector, streamlining workflow automation and enhancing agent capability through standardized context management.
- ⭐ 5,447
- MCP
- Klavis-AI/klavis
Didn't find tool you were looking for?