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：手动设置
先决条件
快速入门
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
支持
如有任何疑问、问题或功能请求，请访问：
执照
该项目根据LICENSE文件中的条款获得许可。