Avr Docs MCP

MCPAI代理

提供方 agentvoiceresponse

AI代理 stdio · 本地进程 会话登录 社区 / 第三方
查看接入方式

一个提供Wiki.JS页面搜索、列表获取和特定页面检索功能的MCP服务器,支持多种传输模式和Docker部署。

一句话选型结论

按资料字段整理

Avr Docs MCP 属于AI代理类 MCP 服务器,stdio · 本地进程,会话登录,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权会话登录 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 3 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量3暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

Wiki.JS集成JavaScript混合部署页面搜索MCP协议Docker支持RESTAPI

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
docker run -d \

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 3 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 3 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Avr Docs MCP当前 3 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方agentvoiceresponse上游标注的维护方 agentvoiceresponse
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.7 KB
来自项目仓库与上游目录的原文,未做删改

AVR文档MCP服务器与Wiki。JS集成

此MCP(模型上下文协议)服务器提供与Wiki的集成。JS用于搜索和列出Wiki中的页面。JS实例。

特性

  • 搜索Wiki。JS页面:使用关键字或主题搜索页面
  • 列出Wiki。JS页面:获取所有可用页面的分页列表
  • 获取特定页面:通过ID检索特定页面
  • 连接测试:测试与Wiki的连接。JS实例
  • 多种运输方式:支持stdio和HTTP流模式
  • Docker支持:已准备好使用带有健康检查的Docker镜像

设置

先决条件

  1. 一个正在运行的Wiki。JS实例
  2. 具有读取页面的适当权限的API密钥

环境变量

您可以通过两种方式设置环境变量:

选项1:使用.env文件(推荐)

  1. 复制示例环境文件:```bash
    cp .env.example .env

2. 编辑 `.env` 文件中包含您的实际值:```bash
# Wiki.JS Configuration
WIKI_JS_BASE_URL=https://your-wiki-instance.com
WIKI_JS_API_KEY=your-api-key-here
LOG_LEVEL=info

# MCP Server Configuration
MCP_MODE=stdio
PORT=3000

选项2:使用系统环境变量```bash

export WIKI_JS_BASE_URL="https://your-wiki-instance.com"
export WIKI_JS_API_KEY="your-api-key-here"
export LOG_LEVEL="info"
export MCP_MODE="stdio"
export PORT="3000"


### 安装

1. 安装依赖项:```bash
npm install
  1. 构建项目:```bash
    npm run build

3. 测试连接(可选):```bash
npm test
  1. 运行服务器:```bash
    npm start

发展:```bash
npm run dev

运行模式

服务器支持两种操作模式:

标准模式(默认)

默认情况下,服务器在stdio模式下运行,通过标准输入/输出进行通信。这是传统的MCP模式。```bash
npm start

or

npm run start:http # for HTTP mode

or

MCP_MODE=stdio npm start


### HTTP流模式

服务器也可以在HTTP模式下运行,为MCP通信提供带有服务器事件(SSE)的REST API。```bash
npm run start:http
# or
MCP_MODE=http npm start

在HTTP模式下运行时,服务器提供:

  • 健康检查: GET /health -返回服务器状态
  • MCP端点: POST /mcp -使用JSON-RPC 2.0的MCP通信端点

测试HTTP模式

您可以使用curl或Postman测试HTTP模式:```bash

Health check

curl http://localhost:3000/health

Initialize MCP session

curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2024-11-05",
"capabilities": {},
"clientInfo": {
"name": "curl-client",
"version": "1.0.0"
}
}
}'

List available tools (use session ID from initialize response)

curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-H "mcp-session-id: " \
-d '{"jsonrpc": "2.0", "id": 2, "method": "tools/list"}'

Call a tool (use session ID from initialize response)

curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-H "mcp-session-id: " \
-d '{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "search_wiki_pages",
"arguments": {
"query": "deepgram",
"page": 1,
"limit": 10
}
}
}'


或者使用内置的测试客户端:```bash
npm run test:http

Docker 使用

使用Docker镜像```bash

Run in stdio mode (default)

docker run -d \
--name avr-docs-mcp \
-e WIKI_JS_BASE_URL="https://your-wiki-instance.com" \
-e WIKI_JS_API_KEY="your-api-key-here" \
agentvoiceresponse/avr-docs-mcp:latest

Run in HTTP mode

docker run -d \
--name avr-docs-mcp \
-p 3000:3000 \
-e WIKI_JS_BASE_URL="https://your-wiki-instance.com" \
-e WIKI_JS_API_KEY="your-api-key-here" \
-e MCP_MODE="http" \
-e PORT="3000" \
agentvoiceresponse/avr-docs-mcp:latest


### Docker Compose```yaml
version: '3.8'

services:
avr-docs-mcp:
image: agentvoiceresponse/avr-docs-mcp:latest
container_name: avr-docs-mcp
ports:
- "3000:3000"  # Only needed for HTTP mode
environment:
- WIKI_JS_BASE_URL=https://your-wiki-instance.com
- WIKI_JS_API_KEY=your-api-key-here
- MCP_MODE=http
- PORT=3000
- LOG_LEVEL=info
restart: unless-stopped
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
interval: 30s
timeout: 10s
retries: 3

可用工具

1.搜索维基页面

在Wiki中搜索页面。JS使用关键字。

参数:

  • query (必填):搜索查询
  • page (可选):分页页码(默认值:1)
  • limit (可选):每页结果数(默认值:10,最大值:50)

2.list_wiki_pages

列出Wiki中的所有可用页面。JS。

参数:

  • page (可选):分页页码(默认值:1)
  • limit (可选):每页结果数(默认值:20,最大值:50)

3.get_wiki_page

通过ID或路径获取特定页面。

参数:

  • pageId (必填):要检索的页面的ID(数字)或路径(字符串)。示例:ID为“3”,路径为“deepgram”

维基。JS API配置

此MCP服务器使用Wiki。JS GraphQL API(/graphql 端点)。确保你的Wiki。JS实例已启用API访问,并且您的API密钥具有以下权限:

  • page:read -阅读页面内容
  • page:list -列出页面
  • search:read -搜索页面

服务器自动处理所有操作的GraphQL查询和响应。请注意Wiki。JS GraphQL API有一些限制:

  • 搜索和列表操作不支持本机分页,因此分页是在客户端模拟的
  • 搜索结果不包括整页内容
  • 列表结果不包括整页内容(使用 get_wiki_page 完整内容)
  • 标签以字符串数组的形式返回,而不是逗号分隔的字符串

日志记录

服务器包括具有可配置日志级别的全面日志记录:

  • debug -详细的调试信息
  • info -一般信息(默认)
  • warn -仅警告消息
  • error -仅错误消息

设置 LOG_LEVEL 环境变量,用于控制日志的详细程度。

错误处理

该服务器包括全面的错误处理功能,用于:

  • 缺少环境变量
  • 网络连接问题
  • API身份验证失败
  • 页面ID无效
  • 速率限制

发展

要在热重新加载的开发模式下运行:```bash
npm run watch


## 建筑

为生产而构建:```bash
npm run build

编译后的JavaScript将位于 dist/ 目录。

支持与社区

  • github: https://github.com/agentvoiceresponse -报告问题,贡献代码。
  • 不一致: https://discord.gg/DFTU69Hg74 -加入社区讨论。
  • Docker Hub: https://hub.docker.com/u/agentvoiceresponse -查找Docker镜像。
  • 维基: https://wiki.agentvoiceresponse.com/en/home -项目文件和指南。

支持AVR

AVR是免费和开源的。
任何支持都是完全自愿的,旨在表达个人的感激之情。
捐赠不提供功能、服务或特殊福利,无论捐赠如何,该项目都是完全可用的。

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Avr Docs MCP 怎么安装?

在客户端按下面的安装命令接入:docker run -d \。装完在客户端配置里引用同一个包或端点。

Avr Docs MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Avr Docs MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Avr Docs MCP 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Avr Docs MCP 能提供哪些能力?

资料显示约 3 个工具;能力标签包括 JavaScript、API集成、Docker支持。具体工具清单以官方文档为准。

Avr Docs MCP 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

Avr Docs MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。