融合式MCP智能体：为数据构建MCP服务器

文档   🌪️    阅读公告    🔥    加入Discord社区

MCP服务器允许Claude等大语言模型发起HTTP请求，使其能够连接API和可执行代码。我们构建这个仓库是为了自己和所有处理数据的人员，方便地将_任何_Python代码直接传递到您本地的Claude应用程序中。

这个仓库提供了一个简单的逐步笔记本工作流程，用于在Claude桌面应用程序中设置MCP服务器，所有内容都是基于Fused用户定义函数（UDFs）用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
  

• 从您喜欢的本地IDE中按照我们的入门笔记本fused_mcp_agents.ipynb进行设置，然后继续到更高级的笔记本创建您自己的智能体和函数

仓库结构

此仓库基于MCP服务器和Fused UDFs构建，它们是可以从任何地方运行的Python函数。

支持与社区

如果您需要帮助解决问题，请随时加入我们的Discord服务器！

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

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

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

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

    }
}

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

# 在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/<您的用户名>/.local/bin/uv",
            "args": ["..."]
        }

    }
}

• 如果Claude运行时没有显示任何连接的工具，请查看MCP文档以解决Claude桌面集成问题

贡献

欢迎提交PR将您自己的UDFs添加到udfs/，以便其他人也可以在本地试用它们！

使用没有Claude桌面应用程序的本地Claude客户端

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

注意：在这里您需要一个Claude API密钥，因为您不会使用桌面应用程序

• 创建一个Anthropic控制台账户

• 创建一个Anthropic API密钥

• 创建一个.env：

  touch .env
  

• 在.env中将您的密钥添加为ANTHROPIC_API_KEY：

  # .env
  ANTHROPIC_API_KEY = "您的密钥在这里"
  

• 启动MCP服务器：

  uv run main.py --agent get_current_time
  

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

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