Fused MCP Agents：为数据设置 MCP 服务器

MCP 服务器 允许像 Claude 这样的大语言模型 (LLM) 发出 HTTP 请求，将它们连接到 API 和可执行代码。我们构建了这个仓库，是为了方便我们自己以及任何处理数据的人，能够轻松地将_任何_ Python 代码直接传递到您自己的桌面 Claude 应用程序。

这个仓库提供了一个简单的逐步 Notebook 工作流程，用于使用 Claude 的桌面应用程序设置 MCP 服务器，所有这些都是在 Fused 用户定义函数 (UDF) 之上用 Python 构建的。

要求

• Python 3.11
• 已安装最新的 Claude 桌面应用程序 (macOS & Windows)

如果您使用的是 Linux，则桌面应用程序不可用，因此我们制作了一个简单的客户端，您也可以使用它在本地运行！

您_不需要_ Fused 帐户来执行任何这些操作！所有这些都将在您的本地计算机上运行。

安装

• 在任何本地目录中克隆此仓库，然后导航到该仓库：

  git clone https://github.com/fusedio/fused-mcp.git
  cd fused-mcp/
  

• 安装 uv（如果您还没有安装）：

  macOS / Linux：

  curl -LsSf https://astral.sh/uv/install.sh | sh
  

  Windows：

  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  

• 通过询问客户端的信息来测试它：

  uv run main.py -h
  

• 首先按照我们的入门 Notebook fused_mcp_agents.ipynb 在您最喜欢的本地 IDE 中进行设置，然后前往更高级的 Notebook 来创建您自己的 Agents 和函数。

仓库结构

此仓库构建在 MCP Server 和 Fused UDF 之上，它们是可以从任何地方运行的 Python 函数。

支持与社区

如果您需要帮助解除阻塞，请随时加入我们的 Discord 服务器！

以下是一些调试设置的常见步骤：

• 运行 uv run main.py -h 应该返回类似这样的内容：

• 您可能需要将全局路径传递给 Claude_Desktop_Config.json 中的某些函数。例如，默认情况下我们只传递 uv：

{
    "mcpServers": {
        "qgis": {
            "command": "uv",
            "args": ["..."]
        }

    }
}

但是您可能需要传递 uv 的完整路径，您可以简单地将其传递给 Notebook 中的 common.generate_local_mcp_config：

# in fused_mcp_agents.ipynb
import shutil 

common.generate_local_mcp_config(
    config_path=PATH_TO_CLAUDE_CONFIG,
    agents_list = ["get_current_time"],
    repo_path= WORKING_DIR,
    uv_path=shutil.which('uv'),
)

这将创建一个如下所示的配置：

{
    "mcpServers": {
        "qgis": {
            "command": "/Users/<YOUR_USERNAME>/.local/bin/uv",
            "args": ["..."]
        }

    }
}

• 如果 Claude 运行但未显示任何连接的工具，请查看 MCP 文档以了解 Claude 桌面设置的故障排除

贡献

欢迎打开 PR，将您自己的 UDF 添加到 udfs/ 中，以便其他人也可以在本地使用它们！

使用本地 Claude 客户端（不使用 Claude 桌面应用程序）

如果您无法安装 Claude 桌面应用程序（例如，在 Linux 上），我们提供 一个小的示例本地客户端界面，用于将 Claude 与此仓库中配置的 MCP 服务器一起使用：

注意：您需要 Claude 的 API 密钥，因为您不会使用桌面应用程序

• 创建一个 Anthropic 控制台帐户

• 创建一个 Anthropic API 密钥

• 创建一个 .env 文件：

  touch .env
  

• 将您的密钥作为 .env 文件中的 ANTHROPIC_API_KEY 添加：

  # .env
  ANTHROPIC_API_KEY = "your-key-here"
  

• 启动 MCP 服务器：

  uv run main.py --agent get_current_time
  

• 在另一个终端会话中，启动本地客户端，指向服务器的地址：

  uv run client.py http://localhost:8080/sse