ONES Wiki MCP Server

1# ONES Wiki MCP Server
2 
3A Spring AI MCP-based service for retrieving ONES Wiki content and converting it to AI-friendly text format.
4 
5## Features
6 
7- 🔐 ONES platform authentication support
8- 🌐 Automatic conversion from Wiki URLs to API endpoints
9- 📄 Extract and format Wiki page content
10- 🤖 AI-friendly text output format
11- ⚙️ Configuration via properties file or command line arguments
12 
13## Prerequisites
14 
15- Java 17 or higher
16- Maven 3.6 or higher
17- Access to a ONES platform instance
18 
19## Quick Start
20 
21### 1. Build the Project
22 
23```bash
24mvn clean package
25```
26 
27### 2. Configure Authentication
28 
29#### Option 1: Modify application.properties
30 
31Edit `src/main/resources/application.properties`:
32 
33```properties
34ones.host=your-ones-host.com
35ones.email=your-email@example.com
36ones.password=your-password
37```
38 
39#### Option 2: Use Command Line Arguments
40 
41```bash
42java -jar target/ones-wiki-mcp-server-0.0.1-SNAPSHOT.jar \
43  --ones.host=your-ones-host.com \
44  --ones.email=your-email@example.com \
45  --ones.password=your-password
46```
47 
48#### Option 3: Use Environment Variables
49 
50```bash
51export ONES_HOST=your-ones-host.com
52export ONES_EMAIL=your-email@example.com
53export ONES_PASSWORD=your-password
54./start-mcp-server.sh
55```
56 
57### 3. Configure in MCP Client
58 
59Add to Claude Desktop configuration file:
60 
61```json
62{
63  "mcpServers": {
64    "ones-wiki": {
65      "command": "java",
66      "args": [
67        "-jar",
68        "/path/to/ones-wiki-mcp-server-0.0.1-SNAPSHOT.jar",
69        "--ones.host=your-ones-host.com",
70        "--ones.email=your-email@example.com",
71        "--ones.password=your-password"
72      ]
73    }
74  }
75}
76```
77 
78## Usage
79 
80### Get Wiki Content
81 
82Provide the complete Wiki page URL when using the tool:
83 
84```
85Please get the content of this Wiki page: https://your-ones-host.com/wiki/#/team/TEAM_UUID/space/SPACE_UUID/page/PAGE_UUID
86```
87 
88### URL Format
89 
90Supported Wiki URL format:
91```
92https://{host}/wiki/#/team/{team_uuid}/space/{space_uuid}/page/{page_uuid}
93```
94 
95Automatically converts to API endpoint:
96```
97https://{host}/wiki/api/wiki/team/{team_uuid}/online_page/{page_uuid}/content
98```
99 
100## Output Format
101 
102The service converts Wiki page HTML content to structured Markdown format, including:
103 
104- ✅ Heading levels (H1-H6)
105- ✅ Paragraph text
106- ✅ Ordered and unordered lists
107- ✅ Table data (key-value format)
108- ✅ Image descriptions
109- ✅ Link information
110- ❌ Strikethrough content (automatically filtered)
111 
112## Technical Architecture
113 
114- **Spring Boot 3.4.5** - Application framework
115- **Spring AI MCP** - MCP protocol support
116- **Jsoup 1.17.2** - HTML parsing
117- **RestClient** - HTTP client
118 
119## Security Notes
120 
121- Authentication credentials should be managed via environment variables or configuration files
122- HTTPS connections supported
123- Automatic handling of ONES platform login authentication
124 
125## Development
126 
127### Project Structure
128 
129```
130src/main/java/org/springframework/ai/mcp/sample/server/
131├── McpServerApplication.java    # Main application
132└── OnesWikiService.java        # ONES Wiki service
133```
134 
135### Running Tests
136 
137```bash
138mvn test
139```
140 
141### Building from Source
142 
143```bash
144git clone https://github.com/your-username/ones-wiki-mcp-server.git
145cd ones-wiki-mcp-server
146mvn clean package
147```
148 
149### Extending Functionality
150 
151You can add more tool methods to `OnesWikiService`, such as:
152- Search Wiki pages
153- Get Wiki directory structure
154- Batch process multiple pages
155 
156## Contributing
157 
1581. Fork the repository
1592. Create a feature branch (`git checkout -b feature/amazing-feature`)
1603. Commit your changes (`git commit -m 'Add some amazing feature'`)
1614. Push to the branch (`git push origin feature/amazing-feature`)
1625. Open a Pull Request
163 
164## License
165 
166Apache License 2.0