星战科技xingzhan.cloud
返回市场
MCP快速网

MCP快速网

作者：fastnai12 星标更新：2025-10-14
安装使用来源：spider==github.com

项目介绍

统一上下文层（UCL）MCP网关

统一上下文层（UCL）是一个多租户模型上下文协议（MCP）服务器，它使AI代理、自动化平台和应用程序能够通过单一标准化的/command端点连接到超过1,000个SaaS工具——如Slack、Jira、Gmail、Shopify、Notion等。UCL抽象了SDK蔓延、粘合代码和复杂的认证流程，允许开发者编排丰富的跨平台集成，而无需为每个服务构建和维护单独的连接器。

功能

  • 集成平台支持 - 使用Fastn服务器访问Slack、Notion、HubSpot等服务
  • 灵活的身份验证 - 使用API密钥或基于租户的身份验证
  • 全面的日志记录 - 详细的日志用于故障排除
  • 错误处理 - 针对各种场景的强大错误管理

先决条件

  • Python 3.10或更高版本

安装选项

选项1：包安装（推荐）

最简单的安装UCL服务器的方法是使用pip：

pip install fastn-mcp-server

要找到已安装命令的确切路径：

  • 在macOS/Linux上：which fastn-mcp-server
  • 在Windows上：where fastn-mcp-server

包安装后

{
  "mcpServers": {
      "fastn": {
          "command": "fastn-mcp-server",
          "args": [
              "--api_key",
              "YOUR_API_KEY",
              "--space_id",
              "YOUR_WORKSPACE_ID"
          ]
      }
  }
}

选项2：手动设置

# 克隆仓库并导航到目录
git clone <your-repo-url> && cd fastn-server

# macOS/Linux: 安装UV，创建虚拟环境并安装依赖项
curl -LsSf https://astral.sh/uv/install.sh | sh && uv venv && source .venv/bin/activate && uv pip install -e .

# Windows (PowerShell): 安装UV，创建虚拟环境并安装依赖项
powershell -c "irm https://astral.sh/uv/install.ps1 | iex" && uv venv && .venv\Scripts\activate && uv pip install -e .

# 直接安装依赖项
uv pip install "httpx>=0.28.1" "mcp[cli]>=1.2.0"

UCL账户设置

  1. 登录您的UCL账户或注册一个新账户
  2. 激活您想要使用的服务/连接器
  3. 转到左侧的“集成”部分，并按照提供的说明将UCL连接到您的代理。
  4. 或者，您也可以选择并使用“集成”部分中提到的不同方法来使用UCL。

运行服务器

服务器支持两种身份验证方法：

身份验证方法1：API密钥

# 包安装
fastn-mcp-server --api_key YOUR_API_KEY --space_id YOUR_WORKSPACE_ID

# 手动安装
uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_WORKSPACE_ID

身份验证方法2：基于租户

# 包安装
fastn-mcp-server --space_id YOUR_WORKSPACE_ID --tenant_id YOUR_TENANT_ID --auth_token YOUR_AUTH_TOKEN

# 手动安装
uv run fastn-server.py --space_id YOUR_WORKSPACE_ID --tenant_id YOUR_TENANT_ID --auth_token YOUR_AUTH_TOKEN

与AI助手集成

Claude集成

  1. 打开Claude配置文件：

    • Windows: notepad "%APPDATA%\Claude\claude_desktop_config.json" 或 code "%APPDATA%\Claude\claude_desktop_config.json"
    • Mac: code ~/Library/Application\ Support/Claude/claude_desktop_config.json

  2. 添加适当的配置：

使用包安装

{
    "mcpServers": {
        "fastn": {
            "command": "/path/to/fastn-mcp-server",
            "args": [
                "--api_key",
                "YOUR_API_KEY",
                "--space_id",
                "YOUR_WORKSPACE_ID"
            ]
        }
    }
}

或者使用租户身份验证：

{
    "mcpServers": {
        "fastn": {
            "command": "/path/to/fastn-mcp-server",
            "args": [
                "--space_id",
                "YOUR_WORKSPACE_ID",
                "--tenant_id",
                "YOUR_TENANT_ID",
                "--auth_token",
                "YOUR_AUTH_TOKEN"
            ]
        }
    }
}

使用手动安装

API密钥身份验证：

{
    "mcpServers": {
        "fastn": {
            "command": "/path/to/your/uv",
            "args": [
                "--directory",
                "/path/to/your/fastn-server",
                "run",
                "fastn-server.py",
                "--api_key",
                "YOUR_API_KEY",
                "--space_id",
                "YOUR_WORKSPACE_ID"
            ]
        }
    }
}

租户身份验证：

{
    "mcpServers": {
        "fastn": {
            "command": "/path/to/your/uv",
            "args": [
                "--directory",
                "/path/to/your/fastn-server",
                "run",
                "fastn-server.py",
                "--space_id",
                "YOUR_WORKSPACE_ID",
                "--tenant_id",
                "YOUR_TENANT_ID",
                "--auth_token",
                "YOUR_AUTH_TOKEN"
            ]
        }
    }
}

Cursor集成

  1. 打开Cursor设置
  2. 导航到“工具与集成”标签并点击“添加自定义MCP”
  3. 点击“添加新的MCP服务器”
  4. 为您的服务器添加一个名称（例如，“fastn”）
  5. 返回UCL，在“集成”部分中，转到“实时事件流”，该部分位于“集成”部分的底部
  6. 复制JSON命令并返回Cursor，将其粘贴到mcp.json文件中并保存。

Docker集成

步骤1：设置环境配置

在项目目录中创建一个.env文件，其中包含您的UCL凭证：

# 配置格式1：基本API密钥和空间ID
API_KEY=your_actual_api_key
SPACE_ID=your_actual_space_id

# 配置格式2：扩展至包含租户ID和认证令牌
TENANT_ID=your_tenant_id
AUTH_TOKEN=your_actual_auth_token

# 设置配置模式：“basic”或“extended”
CONFIG_MODE=extended

步骤2：使用Docker Compose构建和运行

首先，构建并启动容器：

docker-compose up --build

这将创建UCL服务器镜像并验证其是否正确启动。

步骤3：为Docker集成配置AI助手

Claude桌面集成

  1. 打开Claude配置文件：

    • Windows: notepad "%APPDATA%\Claude\claude_desktop_config.json"
    • Mac: code ~/Library/Application\ Support/Claude/claude_desktop_config.json

  2. 添加Docker配置：

{
  "mcpServers": {
    "ucl": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "--env-file", "/path/to/your/fastn-stdio-server/.env",
        "ucl-stdio-server"
      ]
    }
  }
}

注意： 将/path/to/your/fastn-stdio-server/.env替换为您实际的.env文件路径。

替代方案：使用环境变量

如果您更喜欢直接传递环境变量：

{
  "mcpServers": {
    "ucl": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "API_KEY=your_actual_api_key",
        "-e", "SPACE_ID=your_actual_space_id", 
        "-e", "TENANT_ID=your_tenant_id",
        "-e", "AUTH_TOKEN=your_actual_auth_token",
        "-e", "CONFIG_MODE=extended",
        "ucl-stdio-server"
      ]
    }
  }
}

Docker集成的好处

  • 隔离性：UCL服务器在一个安全的容器环境中运行
  • 一致性：不同机器和平台上的相同运行时
  • 简单设置：无需本地安装Python依赖项
  • 可扩展性：可以在云环境中部署或使用Kubernetes进行编排

故障排除

包结构错误

如果在安装过程中遇到如下错误：

ValueError: 无法使用以下启发式确定要放入轮中的文件：
最可能的原因是没有匹配项目名称（fastn）的目录。

快速修复：

  1. 确保pyproject.toml具有轮配置：
[tool.hatch.build.targets.wheel]
packages = ["."]
  1. 然后安装依赖项：
uv pip install "httpx>=0.28.1" "mcp[cli]>=1.2.0"

支持

许可证

本项目根据LICENSE文件中的条款授权。