扩展mcp
MCP服务器 扩展 --从任何兼容MCP的客户端解析、提取、分类、拆分和编辑文档。
快速开始
获取API密钥： dashboard.extend.ai/开发人员.
克劳德桌面版
添加 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"extend": {
"command": "npx",
"args": ["-y", "github:extend-hq/extend-mcp#release"],
"env": {
"EXTEND_API_KEY": "xt_your_key_here"
}
}
}
}重新启动克劳德桌面。将出现扩展工具。
注： Claude Desktop不会自动将本地文件发送到MCP工具。当要求Claude处理文档时，请明确引用完整的文件路径，例如。 *“从中提取数据 /Users/me/Documents/invoice.pdf"*.Alternative: run from a local clone
git clone https://github.com/extend-hq/extend-mcp.git
cd extend-mcp
npm install # builds automatically{
"mcpServers": {
"extend": {
"command": "node",
"args": ["/absolute/path/to/extend-mcp/build/index.js"],
"env": {
"EXTEND_API_KEY": "xt_your_key_here"
}
}
}
}光标
一键安装：将此粘贴到浏览器中：
cursor://anysphere.cursor-deeplink/mcp/install?name=extend&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImdpdGh1YjpleHRlbmQtaHEvZXh0ZW5kLW1jcCNyZWxlYXNlIl0sImVudiI6eyJFWFRFTkRfQVBJX0tFWSI6Inh0X3lvdXJfa2V5X2hlcmUifX0=或添加到 .cursor/mcp.json 在项目根目录中手动执行以下操作：
{
"mcpServers": {
"extend": {
"command": "npx",
"args": ["-y", "github:extend-hq/extend-mcp#release"],
"env": {
"EXTEND_API_KEY": "xt_your_key_here"
}
}
}
}重新启动游标。扩展工具将在代理模式下可用。
注： 当要求Cursor处理本地文件时，请明确引用完整的文件路径，例如。 *“从中提取数据 /Users/me/Documents/invoice.pdf"*.克劳德代码
claude mcp add --transport stdio --env EXTEND_API_KEY=xt_your_key_here extend -- npx -y github:extend-hq/extend-mcp#release扩展工具将在您的下一次对话中提供。
配置
所有配置都是通过环境变量进行的：
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
EXTEND_API_KEY | 是 | - | 您的Extend API密钥 |
EXTEND_ENVIRONMENT | 没有 | us | API地区： us, us2 （HIPAA），或 eu |
EXTEND_TOOLS | 没有 | all | 启用逗号分隔的工具组（见下文） |
EXTEND_DISABLE_FILE_PATH | 否 | -- | 设置为禁用 file_path 参数和 upload_file （用于远程部署） |
过滤工具
默认情况下，所有工具组都处于启用状态。集 EXTEND_TOOLS 以逗号分隔的列表仅注册您需要的列表：
{
"env": {
"EXTEND_API_KEY": "xt_...",
"EXTEND_TOOLS": "parse,extract"
}
}可用组：
| 组 | 工具 |
|---|---|
parse | parse_document |
extract | extract_data, list_extractors, get_extractor |
classify | classify_document, list_classifiers, get_classifier |
split | split_document, list_splitters, get_splitter |
edit | edit_document |
files | upload_file, list_files, get_file |
工具
文档处理
每个文档处理工具都通过以下方式之一接受文件：
file_path--本地文件路径（自动上传到Extend；在以下情况下禁用EXTEND_DISABLE_FILE_PATH已设置）file_url--公共URLfile_id--现有扩展文件ID
parse_文档 --将文档解析为结构化的markdown块。
提取数据 --使用预配置的提取器提取结构化数据(extractor_id)或内联JSON模式(config).
classify文档 --使用预配置的分类器对文档进行分类(classifier_id)或内联类型定义(config).
split_document --使用预配置的拆分器拆分多文档文件(splitter_id)或内联配置。
edit_文档 --使用自然语言填写PDF表单字段 instructions 或通过以下方式显示字段值 config.
配置发现
list_提取器 / get_extractor --浏览和检查提取器。
list_分类器 / get_分类器 --浏览和检查分类器。
list_splitters / get_splitter --浏览并检查分流器。
文件管理
上传文件 --将本地文件上传到Extend，返回文件ID。
列表文件 --列出您的Extend帐户中的文件。
获取文件 --获取文件详细信息和元数据。
许可证
麻省理工学院