Skip to main content
Glama
fastn-ai
by fastn-ai

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

Related MCP server: my-mcp-server

特征

  • 集成平台支持——完成简单设置后,即可通过 Fastn 服务器使用 Slack、Notion、HubSpot 等服务

  • 日志支持——综合日志系统

  • 错误处理——针对各种场景的强大错误管理

分步设置指南

步骤 1:Fastn 设置

  1. 登录您的 Fastn 账户

  2. 从左侧边栏转到“连接器”

  3. 单击“激活”即可激活您想要使用的服务。

  4. 从左侧边栏进入“设置”

  5. 单击“生成 API 密钥”并将其保存在本地某处(例如,在记事本中)

  6. 单击顶部栏(个人资料左侧)上的复制按钮

  7. 复制您的工作区 ID 并保存

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

  1. 找到已安装的 fastn-server 的路径:

    • 在 macOS/Linux 上: which fastn-server

    • 在 Windows 上: where fastn-server

  2. 使用步骤 1 中的路径配置您的 AI 助手。

手动安装(选项 2)

与 Claude 在 Mac OS 上的集成
  1. 打开Claude配置:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json
  1. 添加以下配置(将占位符替换为实际值):

{
    "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 集成
  1. 打开光标设置

  2. 在设置菜单中点击“MCP”

  3. 点击“添加新”

  4. 为您的服务器添加一个名称(例如“fastn”)

  5. 选择“命令”作为类型

  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

详细集成说明

对于克劳德

  1. 打开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.jsoncode ~/Library/Application\ Support/Claude/claude_desktop_config.json

  2. 根据您的安装方法添加适当的配置 JSON。

对于光标

  1. 打开光标设置

  2. 在设置菜单中点击“MCP”

  3. 点击“添加新”

  4. 为您的服务器添加一个名称(例如“fastn”)

  5. 选择“命令”作为类型

  6. 根据您的安装方法使用适当的配置

故障排除

包结构错误

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

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具有轮子配置:

[tool.hatch.build.targets.wheel]
packages = ["."]
  1. 然后安装依赖项:

uv pip install "httpx>=0.28.1" "mcp[cli]>=1.2.0"
  1. 运行服务器:

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

日志记录

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

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

支持

如有任何疑问、问题或功能请求,请访问:

执照

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

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that allows integration with Claude Desktop by creating and managing custom tools that can be executed through the MCP framework.
    52 npm
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    A generic MCP server that dynamically converts OpenAPI-defined REST APIs into tools for LLMs like Claude. It supports multiple authentication methods and transport protocols, enabling seamless interaction with any OpenAPI-compliant API.
    20 npm
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A universal MCP server that connects any REST API to AI assistants via OpenAPI or Postman specifications. It enables dynamic tool creation with GraphQL-style field selection and automatic schema inference for efficient data retrieval.
    8 npm
    6
    -