Fastn 服务器

Fastn 服务器是一个强大且可扩展的平台，它支持基于 API 定义的动态工具注册和执行。它可以无缝地与 Claude.ai 和 Cursor.ai 等服务集成，为各种任务提供统一的服务器解决方案。凭借其强大的架构，Fastn 为实时、API 驱动的操作提供卓越的性能和灵活性。

功能

• 集成平台支持 - 通过 Fastn 服务器使用 Slack、Notion、HubSpot 等服务，只需完成简单的设置
• 日志支持 - 全面的日志记录系统
• 错误处理 - 针对各种场景的强大错误管理

逐步设置指南

步骤 1：Fastn 设置

1. 登录您的 Fastn 帐户
2. 从左侧边栏转到“Connectors”（连接器）
3. 单击“activate”（激活）以激活您想要使用的服务。
4. 从左侧边栏转到“Settings”（设置）
5. 单击“Generate API Key”（生成 API 密钥）并将其保存在本地的某个位置（例如，在记事本中）
6. 单击顶部栏（您的个人资料左侧）上存在的复制按钮
7. 复制您的 Workspace ID（工作区 ID）并将其保存
8. 现在 Fastn 的所有设置都已完成

步骤 2：服务器设置

前提条件

• Python 3.10 或更高版本

快速开始

macOS

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

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

# 运行服务器（使用 --platform 标志指定平台）
uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID

Windows

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

# 安装 UV，创建一个虚拟环境，并安装依赖项
# 选项 1：使用 pip 安装 UV
python -m pip install uv
# 确保复制安装路径并将其添加到您的 Windows 环境变量中。

# 选项 2：使用 PowerShell 安装 UV
powershell -c "irm https://astral.sh/uv/install.ps1 | iex" && uv venv && .venv\Scripts\activate && uv pip install -e .

# 运行服务器（使用 --platform 标志指定平台）
uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID

步骤 3：与 Mac OS 上的 Claude 集成

1. 打开 Claude 配置：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

2. 添加以下配置（将占位符替换为您的实际值）：

{
    "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"
            ]
        }
    }
}

步骤 4：与 Cursor 集成

1. 打开 Cursor 设置
2. 在设置菜单中单击“MCP”
3. 单击“Add New”（添加新项）
4. 为您的服务器添加一个名称（例如，“fastn”）
5. 选择“Command”（命令）作为类型
6. 添加以下命令（将占位符替换为您的实际值）：

/path/to/your/uv --directory /path/to/your/fastn-server run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_WORKSPACE_ID

故障排除

包结构错误

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

ValueError: Unable to determine which files to ship inside the wheel using the following heuristics:
The most likely cause of this is that there is no directory that matches the name of your project (fastn).

快速修复：

1. 确保 pyproject.toml 具有 wheel 配置：

[tool.hatch.build.targets.wheel]
packages = ["."]

2. 然后安装依赖项：

uv pip install "httpx>=0.28.1" "mcp[cli]>=1.2.0"

3. 运行服务器：

uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID

日志记录

日志以以下格式输出，包含时间戳、级别和消息：

%(asctime)s - %(levelname)s - %(message)s