Fused MCP Agents

MCP 服务器允许像 Claude 这样的 LLM 发出 HTTP 请求，并将其连接到 API 和可执行代码。我们为自己以及任何数据工作者构建了这个代码库，以便轻松地将任何Python 代码直接传输到您自己的桌面 Claude 应用程序中。

这个 repo 提供了一个简单的分步笔记本工作流程，用于使用 Claude 的桌面应用程序设置MCP 服务器，所有这些都是在 Python 中基于融合用户定义函数(UDF) 构建的。

要求

• Python 3.11

• 安装了最新的Claude Desktop 应用程序（macOS 和 Windows）

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

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

Related MCP server: computer-use-mcp

安装

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

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

• 如果你没有uv ，请安装它：

  macOS / Linux：

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

  视窗：

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

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

  uv run main.py -h

• 首先在您最喜欢的本地 IDE 中按照我们的入门笔记本fused_mcp_agents.ipynb进行设置，然后进入更高级的笔记本来创建您自己的代理和功能

存储库结构

这个 repo 建立在MCP Server和Fused UDF之上，它们是可以从任何地方运行的 Python 函数。

支持与社区

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

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

• 运行uv run main.py -h应该返回如下内容：

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

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

    }
}

但是您可能需要将完整路径传递给uv ，您可以简单地将其传递给笔记本中的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 Desktop 设置故障

贡献

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

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

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

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

• 创建Anthropic Console 帐户

• 创建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