Unstructured API MCP 服务器

非结构化API MCP服务器

用于与非结构化API交互的MCP服务器实现。此服务器提供列出源和工作流的工具。

可用工具

以下是连接器列表 UNS-MCP 服务器当前支持，请查看非结构化平台支持的源连接器的完整列表 这里 目的地列表 这里。我们计划添加更多！

要使用创建/更新/删除连接器的工具，必须在.env文件中定义该特定连接器的凭据。以下是列表 credentials 对于我们支持的连接器：

Firecrawl源

火爬 是一个网络抓取API，它在我们的MCP中提供了两个主要功能：

1. HTML内容检索：使用 invoke_firecrawl_crawlhtml 开始爬行作业 check_crawlhtml_status 监控他们
2. LLM优化文本生成：使用 invoke_firecrawl_llmtxt 生成文本和 check_llmtxt_status 检索结果

Firecrawl的工作原理：

Web爬网过程：

• 从指定的URL开始，并对其进行分析以识别链接
• 使用站点地图（如果可用）；否则，请点击网站上的链接
• 递归遍历每个链接以发现所有子页面
• 从每个访问过的页面收集内容，处理JavaScript渲染和速率限制
• 作业可以通过以下方式取消 cancel_crawlhtml_job 如有需要
• 如果您需要将所有信息提取到原始HTML中，请使用此功能，Unstructured的工作流程可以很好地清理它：微笑：

LLM文本生成：

• 爬行后，从爬行的页面中提取干净、有意义的文本内容
• 生成专门为大型语言模型格式化的优化文本格式
• 结果会自动上传到指定的S3位置
• 注意：LLM文本生成作业一旦启动就不能取消。这 cancel_llmtxt_job 函数是为了保持一致性而提供的，但Firecrawl API当前不支持该函数。

注：A FIRECRAWL_API_KEY 必须设置环境变量才能使用这些函数。

安装和配置

本指南提供了使用Python 3.12和 uv 工具。

先决条件

• Python 3.12+
• uv 环境管理
• 来自Unstructured的API密钥。您可以注册并获取您的API密钥 这里.

使用 uv （推荐）

使用时无需额外安装 uvx 因为它处理执行。但是，如果您更喜欢直接安装该软件包：

uv pip install uns_mcp

配置Claude桌面

要与Claude Desktop集成，请将以下内容添加到您的 claude_desktop_config.json:

注： 该文件位于 ~/Library/Application Support/Claude/ 目录。

使用 uvx 命令：

{
   "mcpServers": {
      "UNS_MCP": {
         "command": "uvx",
         "args": ["uns_mcp"],
         "env": {
           "UNSTRUCTURED_API_KEY": "<your-key>"
         }
      }
   }
}

或者，使用Python包：

{
   "mcpServers": {
      "UNS_MCP": {
         "command": "python",
         "args": ["-m", "uns_mcp"],
         "env": {
           "UNSTRUCTURED_API_KEY": "<your-key>"
         }
      }
   }
}

使用源代码

1. 克隆存储库。

2. 安装依赖项：

   复制

   uv sync
   

3. 将非结构化API键设置为环境变量。在根目录中创建一个.env文件，内容如下：

   复制

   UNSTRUCTURED_API_KEY="YOUR_KEY"
   

   参见 .env.template 对于可配置的环境变量。

现在，您可以使用以下方法之一运行服务器：

uvx pip install -e .

{
  "mcpServers": {
    "UNS_MCP": {
      "command": "uvx",
      "args": ["uns_mcp"]
    }
  }
}

{
  "mcpServers": {
    "UNS_MCP": {
      "command": "ABSOLUTE/PATH/TO/.local/bin/uv",
      "args": [
        "--directory",
        "ABSOLUTE/PATH/TO/YOUR-UNS-MCP-REPO/uns_mcp",
        "run",
        "server.py"
      ]
    }
  }
}

uv run python minimal_client/client.py uns_mcp/server.py

其他本地客户端配置

使用环境变量配置最小客户端：

• LOG_LEVEL="ERROR"：设置为禁止LLM的调试输出，为用户显示清晰的消息。
• CONFIRM_TOOL_USE='false'：执行前禁用工具使用确认。 谨慎使用，特别是在开发过程中，因为LLM可能会执行昂贵的工作流或删除数据。

调试工具

Anthropic提供 MCP Inspector 用于调试/测试MCP服务器的工具。运行以下命令以启动调试UI。从那里，您将能够在左侧窗格中添加环境变量（指向您的本地环境变量）。将您的个人API密钥作为env var.包含在其中。转到 tools，您可以测试添加到MCP服务器的功能。

mcp dev uns_mcp/server.py

如果您需要将请求调用参数记录到 UnstructuredClient，设置环境变量 DEBUG_API_REQUESTS=false. 日志存储在一个文件中，格式为 unstructured-client-{date}.log，可以检查这些参数以调试请求调用参数 UnstructuredClient 功能。

向最小客户端添加终端访问权限

我们将使用 @wonderwhy er/桌面命令 以向最小客户端添加终端访问。它建立在MCP文件系统服务器上。小心，因为客户（也是法学硕士）现在 可以访问私人文件。

执行以下命令安装软件包：

npx @wonderwhy-er/desktop-commander setup

然后使用额外的参数启动客户端：

uv run python minimal_client/client.py "http://127.0.0.1:8080/sse" "@wonderwhy-er/desktop-commander"
# or
make sse-client-terminal

使用工具子集

如果你的客户只支持使用部分工具，以下是你应该注意的事项：

• update_workflow 工具必须与以下内容一起加载到上下文中 create_workflow 工具，因为它包含有关如何创建和配置自定义节点的详细描述。

已知问题

• update_workflow -需要在上下文中包含它正在更新的工作流的配置，可以由用户提供，也可以通过调用 get_workflow_info 工具，因为这个工具不起作用 patch applier，它完全取代了工作流配置。

更改日志.md

任何新开发的功能/修复/增强都将添加到CHANGELOG.md.0.x.dev预发布格式中，然后再升级到稳定版本。

故障排除

• 如果您遇到以下问题 Error: spawn <command> ENOENT 意思 <command> 在您的PATH中未安装或不可见：
  • 确保安装它并将其添加到PATH中。
  • 或在中提供命令的绝对路径 command 配置的字段。例如，替换 python 随着 /opt/miniconda3/bin/python