Ones Wiki Mcp Server

ONES Wiki MCP 服务

一项基于 Spring AI MCP 的服务，用于获取 ONES Wiki 内容并将其转换为适合 AI 使用的文本格式。

功能

• 🔐 支持 ONES 平台身份验证
• 🌐 自动将 Wiki URL 转换为 API 端点
• 📄 提取并格式化 Wiki 页面内容
• 🤖 输出适合 AI 使用的文本格式
• ⚙️ 通过属性文件或命令行参数进行配置

前置条件

• Java 17 或更高版本
• Maven 3.6 或更高版本
• 可访问 ONES 平台实例

快速开始

1. 构建项目

mvn clean package

2. 配置身份验证

选项 1：修改 application.properties

编辑 src/main/resources/application.properties：

ones.host=your-ones-host.com
[email protected]
ones.password=your-password

选项 2：使用命令行参数

java -jar target/ones-wiki-mcp-server-0.0.1-SNAPSHOT.jar \
  --ones.host=your-ones-host.com \
  [email protected] \
  --ones.password=your-password

选项 3：使用环境变量

export ONES_HOST=your-ones-host.com
export [email protected]
export ONES_PASSWORD=your-password
./start-mcp-server.sh

3. 在 MCP 客户端中配置

添加到 Claude Desktop 配置文件：

{
  "mcpServers": {
    "ones-wiki": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/ones-wiki-mcp-server-0.0.1-SNAPSHOT.jar",
        "--ones.host=your-ones-host.com",
        "[email protected]",
        "--ones.password=your-password"
      ]
    }
  }
}

使用方法

获取 Wiki 内容

使用工具时，请提供完整的 Wiki 页面 URL：

Please get the content of this Wiki page: https://your-ones-host.com/wiki/#/team/TEAM_UUID/space/SPACE_UUID/page/PAGE_UUID

URL 格式

支持的 Wiki URL 格式：

https://{host}/wiki/#/team/{team_uuid}/space/{space_uuid}/page/{page_uuid}

自动转换为 API 端点：

https://{host}/wiki/api/wiki/team/{team_uuid}/online_page/{page_uuid}/content

输出格式

该服务会将 Wiki 页面 HTML 内容转换为结构化的 Markdown 格式，包括：

• ✅ 标题级别（H1-H6）
• ✅ 段落文本
• ✅ 有序列表和无序列表
• ✅ 表格数据（键值格式）
• ✅ 图片描述
• ✅ 链接信息
• ❌ 删除线内容（自动过滤）

技术架构

• Spring Boot 3.4.5 - 应用框架
• Spring AI MCP - MCP 协议支持
• Jsoup 1.17.2 - HTML 解析
• RestClient - HTTP 客户端

安全说明

• 应通过环境变量或配置文件管理身份验证凭据
• 支持 HTTPS 连接
• 自动处理 ONES 平台登录身份验证

开发

项目结构

src/main/java/org/springframework/ai/mcp/sample/server/
├── McpServerApplication.java    # Main application
└── OnesWikiService.java        # ONES Wiki service

运行测试

mvn test

从源代码构建

git clone https://github.com/your-username/ones-wiki-mcp-server.git
cd ones-wiki-mcp-server
mvn clean package

扩展功能

你可以向 OnesWikiService 添加更多工具方法，例如：

• 搜索 Wiki 页面
• 获取 Wiki 目录结构
• 批量处理多个页面

贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 将分支推送到仓库（git push origin feature/amazing-feature）
5. 发起 Pull Request

许可证

Apache License 2.0