Fastn 服务器

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

入门

软件包安装（推荐）

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

pip install fastn-mcp-server

安装后，您可以使用以下命令运行服务器：

fastn-mcp-server --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID

使用包安装时，您的 AI 助手配置将如下所示：

macOS/Linux：

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

视窗：

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

要查找已安装的 fastn-server 命令的确切路径：

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

特征

集成平台支持——完成简单设置后，即可通过 Fastn 服务器使用 Slack、Notion、HubSpot 等服务
日志支持——综合日志系统
错误处理——针对各种场景的强大错误管理

分步设置指南

步骤 1：Fastn 设置

登录您的 Fastn 账户
从左侧边栏转到“连接器”
单击“激活”即可激活您想要使用的服务。
从左侧边栏进入“设置”
单击“生成 API 密钥”并将其保存在本地某处（例如，在记事本中）
单击顶部栏（个人资料左侧）上的复制按钮
复制您的工作区 ID 并保存
Fastn 的所有设置现已完成

第 2 步：服务器设置

选项 1：使用包安装（推荐）

请参阅上面的“包安装”部分。

选项 2：手动设置

先决条件

Python 3.10 或更高版本

快速入门

macOS

# Clone repository and navigate to directory
git clone <your-repo-url> && cd fastn-server

# Install UV, create virtual environment, and install dependencies in one go
curl -LsSf https://astral.sh/uv/install.sh | sh && uv venv && source .venv/bin/activate && uv pip install -e .

# Run server (specify platform with --platform flag)
uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID 

视窗

# Clone repository and navigate to directory
git clone <your-repo-url> && cd fastn-server

# Install UV, create a virtual environment, and install dependencies
# Option 1: Install UV using pip
python -m pip install uv
# Make sure to copy the installation path and add it to your Windows environment variables.

# Option 2: Install UV using PowerShell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex" && uv venv && .venv\Scripts\activate && uv pip install -e .

# Run server (specify platform with --platform flag)
uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID 

步骤3：与AI助手集成

对于包安装（选项 1）

找到已安装的 fastn-server 的路径：
- 在 macOS/Linux 上： which fastn-server
- 在 Windows 上： where fastn-server
使用步骤 1 中的路径配置您的 AI 助手。

手动安装（选项 2）

与 Claude 在 Mac OS 上的集成

打开Claude配置：

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

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

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

与 Cursor 集成

打开光标设置
在设置菜单中点击“MCP”
点击“添加新”
为您的服务器添加一个名称（例如“fastn”）
选择“命令”作为类型
添加以下命令（用实际值替换占位符）：

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

详细集成说明

对于克劳德

打开Claude配置文件：
- Windows： notepad "%APPDATA%\Claude\claude_desktop_config.json"或code "%APPDATA%\Claude\claude_desktop_config.json"
- Mac： open -a TextEdit ~/Library/Application\ Support/Claude/claude_desktop_config.json或code ~/Library/Application\ Support/Claude/claude_desktop_config.json
根据您的安装方法添加适当的配置 JSON。

对于光标

打开光标设置
在设置菜单中点击“MCP”
点击“添加新”
为您的服务器添加一个名称（例如“fastn”）
选择“命令”作为类型
根据您的安装方法使用适当的配置

故障排除

包结构错误

如果在安装过程中遇到类似这样的错误：

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).

快速修复：

确保pyproject.toml具有轮子配置：

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

然后安装依赖项：

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

运行服务器：

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

日志记录

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

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

支持

如有任何疑问、问题或功能请求，请访问：

文档： https://docs.fastn.ai
社区： https://community.fastn.ai

执照

该项目根据LICENSE文件中的条款获得许可。

Fastn Server

Integrations