Extend AI MCP 服务器

一个只读的模型上下文协议(MCP)服务器,将Extend AI的文档处理数据暴露为AI助手的工具。

  • by caiomoura1994
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 caiomoura1994/Extend-AI-MCP-Server

使用说明

扩展AI MCP服务器

免责声明: 这是一个 非官方的,社区维护的MCP服务器 扩展AI确实如此 不 与Extend AI有关联、得到其认可或得到其官方支持。该项目是独立构建的,旨在将Extend AI的文档处理功能与MCP兼容的客户端集成在一起。请自行决定使用。

只读 模型上下文协议 暴露的(MCP)服务器 扩展AI 将文档处理数据作为Claude Desktop、Cursor和其他MCP客户端等AI助手的工具。

它的作用

此服务器为您的AI助手提供了对Extend AI帐户数据的只读访问权限:

  • 处理器 -列出处理器并检查处理器运行结果
  • 工作流 -列出工作流并检查工作流运行结果
  • 提取器 -列出提取程序、版本并检查提取运行
  • 解析 -检查解析运行结果
  • 文件 -列出上传的文件

所有操作都是 只读 --此服务器无法创建、修改或删除您的Extend AI帐户中的任何资源。

可用工具

类别 工具 描述
处理器 list_processors 列出所有可用处理器
get_processor_run 获取处理器执行的状态和结果
工作流 list_workflows 列出所有可用工作流
list_workflow_runs 列出所有工作流执行运行及其状态和元数据
get_workflow_run 获取工作流执行的状态和结果
提取器 list_extractors 列出所有可用的提取器
list_extract_runs 列出所有提取器执行运行
get_extractor 获取特定提取器的详细信息
list_extractor_versions 列出特定提取器的所有版本
get_extractor_version 获取提取器的特定版本
解析 get_parse_run 获取解析操作的结果
文件 list_files 列出上传到帐户的所有文件

安装

从下面三个选项中选择一个。安装后,跳到 设置 配置您的MCP客户端。

选项1:npx(推荐)

需要 Node.js 18+.无需安装步骤--直接运行:

npx -y extend-ai-mcp-server

首次运行时,它会下载适用于您操作系统的正确二进制文件,并将其缓存在 ~/.extend-mcp-server/。后续运行立即开始。

选项2:开始

需要 转到1.23+.也可以直接运行,无需安装步骤:

go run github.com/caiomoura/extend-mcp-server/cmd/extend-mcp-server@latest

Go会自动下载并编译服务器。该构建已缓存,以便后续快速启动。

选项3:预构建二进制文件

没有运行时依赖关系。下载自 GitHub发布:

macOS (Apple Silicon)
curl -Lo extend-mcp-server.tar.gz https://github.com/caiomoura1994/Extend-AI-MCP-Server/releases/latest/download/extend-mcp-server_darwin_arm64.tar.gz
tar xzf extend-mcp-server.tar.gz && rm extend-mcp-server.tar.gz
sudo mv extend-mcp-server /usr/local/bin/
macOS (Intel)
curl -Lo extend-mcp-server.tar.gz https://github.com/caiomoura1994/Extend-AI-MCP-Server/releases/latest/download/extend-mcp-server_darwin_amd64.tar.gz
tar xzf extend-mcp-server.tar.gz && rm extend-mcp-server.tar.gz
sudo mv extend-mcp-server /usr/local/bin/
Linux (x86_64)
curl -Lo extend-mcp-server.tar.gz https://github.com/caiomoura1994/Extend-AI-MCP-Server/releases/latest/download/extend-mcp-server_linux_amd64.tar.gz
tar xzf extend-mcp-server.tar.gz && rm extend-mcp-server.tar.gz
sudo mv extend-mcp-server /usr/local/bin/
Linux (ARM64)
curl -Lo extend-mcp-server.tar.gz https://github.com/caiomoura1994/Extend-AI-MCP-Server/releases/latest/download/extend-mcp-server_linux_arm64.tar.gz
tar xzf extend-mcp-server.tar.gz && rm extend-mcp-server.tar.gz
sudo mv extend-mcp-server /usr/local/bin/
Windows (x86_64)
  1. 下载 extend-mcp-server_windows_amd64.zip
  2. 提取 extend-mcp-server.exe
  3. 将其移动到PATH中的某个目录(例如。 C:\Program Files\extend-mcp-server\)

设置

将以下内容添加到MCP客户端配置中。更换 command 和 args 取决于您选择的安装选项:

安装 command args
新巴拿马型船舶 "npx" ["-y", "extend-ai-mcp-server"]
走 "go" ["run", "github.com/caiomoura/extend-mcp-server/cmd/extend-mcp-server@latest"]
二进制 "/usr/local/bin/extend-mcp-server" 不需要

使用npx的示例:

{
  "mcpServers": {
    "extend-ai": {
      "command": "npx",
      "args": ["-y", "extend-ai-mcp-server"],
      "env": {
        "EXTEND_API_KEY": "your_api_key_here"
      }
    }
  }
}

将此配置放在哪里:

客户端 配置文件
克劳德桌面 (macOS) ~/Library/Application Support/Claude/claude_desktop_config.json
克劳德桌面 (Windows) %APPDATA%\Claude\claude_desktop_config.json
光标 .cursor/mcp.json 在您的项目中,或全局游标MCP设置中

保存后重新启动MCP客户端。

配置

所有配置都是通过环境变量完成的 env MCP配置块:

变量 必填 默认 描述
EXTEND_API_KEY 是 - 您的Extend AI API密钥
EXTEND_API_VERSION 没有 2026-02-09 扩展AI API版本
EXTEND_BASE_URL 没有 https://api.extend.ai 扩展AI API基础URL

区域终点

如果您的Extend AI帐户位于区域实例(例如US2)上,请添加 EXTEND_BASE_URL 到 env 块:

"env": {
  "EXTEND_API_KEY": "your_api_key_here",
  "EXTEND_BASE_URL": "https://api.us2.extend.app"
}

故障排除

问题 解决方案
command not found 使用二进制文件的完整路径,或确保Node.js/Go在您的path中
服务器无法启动 请检查 EXTEND_API_KEY 在MCP客户端配置中设置
工具未出现 配置更改后重新启动MCP客户端
404 API错误 检查 EXTEND_BASE_URL 匹配您的区域实例
401 API错误 验证您的API密钥是否有效且处于活动状态
找不到终结点 检查 EXTEND_API_VERSION 匹配可用端点

贡献

欢迎投稿!看 贡献.md 用于开发设置、架构概述和指南。

链接

许可证

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