<div align="center"> <img src="assets/banner.png" alt="Appwrite 文档 MCP 服务器" width="700" /> </div>

Appwrite 文档 MCP 服务器

此 MCP 服务器是一个工具，允许 IDE（如 Cursor、Windsurf、Claude Code 等）利用 Appwrite 文档。

在您的 IDE 中使用（Cursor、Windsurf、Claude Code 等）

Cursor

<strong><a href="https://apwr.dev/docs-mcp-cursor?ref=appwrite-docs-mcp-github">点击这里将 Appwrite 文档 MCP 服务器添加到 Cursor</a></strong>

VSCode

<strong><a href="https://apwr.dev/docs-mcp-vscode?ref=appwrite-docs-mcp-github">点击这里将 Appwrite 文档 MCP 服务器添加到 VSCode</a></strong>

Claude Code

运行以下命令以将 MCP 服务器添加到 Claude Code：

claude mcp add appwrite-docs-mcp https://mcp-for-docs.appwrite.io -t http

Windsurf

在全局 Windsurf MCP 配置文件中添加以下内容（~/.codeium/windsurf/mcp_config.json）：

{
  "mcpServers": {
    "appwrite-docs-mcp": {
      "serverUrl": "https://mcp-for-docs.appwrite.io"
    }
  }
}

开发

在设置之前，请确保已安装 Bun。

然后，安装依赖项：

bun install

查看 .env.example 文件以了解需要设置的环境变量。

本地运行（无 Docker）

初始化

设置 MCP 服务器涉及三个过程，以确保我们拥有最新版本的文档。

• 下载内容： 此脚本将文档下载到 ./content 并生成一个目录 JSON 文件。
• 初始化向量存储： 此脚本使用文档和相关元数据初始化向量存储（使用本地 LibSQL 数据库）。

只需运行以下命令即可初始化 MCP 服务器：

bun run init

构建并运行 MCP 服务器

首先，构建服务器：

bun run build

然后，启动 MCP 服务器：

bun run start

默认情况下，服务器应可在 http://localhost:1234 访问。

使用 Docker 设置

运行以下命令以构建 Docker 镜像：

bun run init
docker compose build
docker compose up

使用

通过 MCP 检查器检查

只需运行以下命令即可检查 MCP 服务器：

bun run mcp-inspect

浏览器标签页将打开检查器界面。

<div align="center"> <img src="assets/inspector.png" alt="MCP 检查器" width="700" /> </div>

在您的 IDE 中使用（Cursor、Windsurf、Claude Code 等）

这是一个示例配置文件：

// .cursor/mcp.json
{
  "mcpServers": {
    "appwrite-docs-mcp": {
      "url": "http://localhost:1234"
    }
  }
}

相同的配置适用于任何标准 MCP 客户端（Windsurf、Cursor、Claude、Claude Code 等）。