Wiki模型连接服务

GROWI MCP Server是一个为GROWI Wiki提供AI模型连接的HTTP服务器,支持Bearer认证,实现页面、标签、修订等内容的操作与管理。

  • by MechanicalGirlDev
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 MechanicalGirlDev/growi-mcp

使用说明

GROWI MCP服务器

GROWI Wiki的AI连接模型Model Context Protocol (MCP) HTTP服务器。Bearer支持认证。

机能

页面操作

  • getPage -获取页面内容
  • getPageInfo -获取页面信息
  • createPage -创建页面
  • updatePage -更新页面
  • deletePage -删除页面
  • duplicatePage -复制页面
  • renamePage -移动/重命名页面
  • searchPages -查找页面
  • getRecentPages -检索最近更新的页面
  • getPageListingRoot -获取根页面列表
  • getPageListingChildren -检索子页面列表
  • publishPage / unpublishPage -发布/隐藏页面

标记操作

  • getTagList -获取标记列表
  • searchTags -查找标记
  • updateTag -更新标记
  • getPageTag -获取页面标记

修订操作

  • listRevisions -获取修订列表
  • getRevision -获取修订

共享链接操作

  • getShareLinks -获取共享链接列表
  • createShareLink -创建共享链接
  • deleteShareLink -删除共享链接

注释操作

  • getComments -获取注释

用户操作

  • getUserRecentPages -用户最近的页面检索

安装,安装

环境变数

.env.example复制.env创建:

cp .env.example .env
变数名 说明 例
MCP_HTTP_PORT 服务器端口 3001
MCP_HTTP_HOST 监听主机 0.0.0.0
MCP_AUTH_TOKENS Bearer验证标记(32个字符或更多个逗号分隔符) your-secure-token...
GROWI_DEFAULT_APP_NAME 默认GROWI应用程序名称 app-1
GROWI_APP_NAME_N GROWI应用程序名称(N=1,2,3…) app-1
GROWI_API_TOKEN_N GROWI API令牌| 8991502f6dfec...
GROWI_BASE_URL_N 生长URL http://localhost:3000

起动方法

Docker Compose(Cloudflare隧道)

Cloudflare Tunnel而需要与环境混合的每条反射光线,进行环境采样HTTPS实现访问。

  1. Cloudflare Tunnel创建:

    • Cloudflare零信任 访问
    • 网络>隧道>创建隧道
    • 通过输入隧道名称创建
    • 复制标记
  2. 隧道的Public Hostname 设置:

    • Subdomain: 任意(例: growi-mcp)
    • Domain: Cloudflare已注册的域
    • 服务类型: HTTP
    • 网址: growi-mcp:3001
  3. .env设置:

    cp .env.example .env
    # CLOUDFLARE_TUNNEL_TOKEN にトークンを設定
    
  4. 起动:

    docker compose up -d
    
  5. 访问:

    • https://growi-mcp.your-domain.com/mcp

本地开发

# 依存関係のインストール
pnpm install

# 開発サーバー起動
pnpm dev

# ビルド
pnpm build

# 本番起動
pnpm start

API

端点

  • GET /health -健康检查
  • POST /mcp - MCP请求

认证

在请求标题中Bearer包括标记:

Authorization: Bearer your-secure-token-at-least-32-characters-long

许可证

麻省理工学院