扩展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(推荐)
需要 .无需安装步骤--直接运行:
npx -y extend-ai-mcp-server首次运行时,它会下载适用于您操作系统的正确二进制文件,并将其缓存在 ~/.extend-mcp-server/。后续运行立即开始。选项2:开始
需要 转到1.23+.也可以直接运行,无需安装步骤:
go run github.com/caiomoura/extend-mcp-server/cmd/extend-mcp-server@latestGo会自动下载并编译服务器。该构建已缓存,以便后续快速启动。
选项3:预构建二进制文件
没有运行时依赖关系。下载自 :
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)
- 下载 extend-mcp-server_windows_amd64.zip
- 提取
extend-mcp-server.exe - 将其移动到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许可证-请参阅 许可证 文件以获取详细信息。
