Rowik MCP服务器使用说明

项目简介

Rowik MCP服务器是一个专为个人MediaWiki设计的MCP服务器实现。它利用MediaWiki API提供了一系列工具，允许LLM客户端查询和操作您的个人wiki站点。通过此服务器，LLM应用可以方便地获取wiki内容，进行知识检索和利用。

主要功能点

搜索页面 (search_personal_wiki): 根据关键词在wiki中搜索相关页面，返回页面标题、ID和摘要。
获取页面内容 (get_personal_wiki_page): 根据页面标题或ID获取wiki页面的完整内容和最后修改时间。
列出分类页面 (list_category_pages): 获取指定分类下的所有页面列表，包括页面标题和ID。
列出所有页面 (list_all_pages): 获取wiki站点所有页面的列表。
列出最近修改页面 (list_recent_pages): 获取最近修改过的页面列表。

安装步骤

安装 'mcp' 库: 确保您的Python环境中安装了 'mcp' 库。如果尚未安装，请使用pip安装：

pip install mcp
pip install httpx pydantic # 补充安装依赖库

下载仓库代码: 从GitHub仓库 https://github.com/roshan/rowik-mcp 下载 'main.py' 文件。

服务器配置

MCP客户端需要配置以下信息以连接到 Rowik MCP 服务器。以下是 JSON 格式的配置信息，请复制到您的MCP客户端配置中：

{
  "serverName": "rowik",
  "command": "python",
  "args": ["main.py"],
  "transport": "stdio"
}

配置参数说明:

'serverName': 服务器名称，这里设置为 "rowik"，与代码中 'FastMCP("rowik")' 初始化时保持一致。
'command': 启动服务器的命令，通常为 'python'，假设您使用Python环境运行服务器。
'args': 启动命令的参数，这里指定运行 'main.py' 文件。请确保 'main.py' 文件位于MCP客户端能够执行的路径下，或者使用绝对路径。
'transport': 传输协议，这里设置为 'stdio'，表示使用标准输入输出进行通信。

注意: 请确保您的MCP客户端支持 'stdio' 传输协议。您可能需要在运行MCP客户端的环境中，将 'main.py' 文件放置在合适的位置，并配置正确的Python环境。

基本使用方法

启动服务器: 在安装了 'mcp' 库和 'main.py' 文件所在的目录下，打开终端并执行配置中指定的命令：
```
python main.py
```
服务器将通过标准输入输出等待MCP客户端的请求。
配置MCP客户端: 在您的MCP客户端中，根据上述 “服务器配置” 部分的信息，配置连接到 Rowik MCP 服务器。确保客户端使用 'stdio' 传输协议，并将命令和参数配置正确。
使用工具: 一旦客户端成功连接到服务器，您就可以通过客户端调用服务器提供的工具，例如 'search_personal_wiki'、'get_personal_wiki_page' 等，来访问和操作您的个人MediaWiki站点。具体的工具参数和使用方法请参考代码中的函数定义和参数模型。

示例 (假设您使用的MCP客户端支持工具调用):

您可以使用客户端调用 'search_personal_wiki' 工具来搜索wiki页面，例如，搜索关键词 "example page"：

{
  "jsonrpc": "2.0",
  "method": "call_tool",
  "params": {
    "tool_name": "search_personal_wiki",
    "tool_args": {
      "query": "example page"
    }
  },
  "id": "1"
}

服务器将返回搜索结果，客户端可以解析并展示给用户或LLM。

请根据您的MCP客户端的具体使用方式和文档，进行更详细的操作和工具调用。