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: MCP Manager
特征
集成平台支持——完成简单设置后,即可通过 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支持
如有任何疑问、问题或功能请求,请访问:
执照
该项目根据LICENSE文件中的条款获得许可。
This server cannot be installed
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.