Fastn

🚀 Fastn 服务器

Fastn 是一个强大的平台，它集成了多个工具和服务，能显著提升工作效率。该平台支持与 Claude、Cursor 等多种 AI 助手无缝连接，还提供详细的日志记录和实用的故障排除指南。

🚀 快速开始

📦 安装指南

推荐使用包管理器进行安装：

uv pip install fastn

🏃 运行服务器

运行 Fastn 服务器时，可指定 API Key 和 Workspace ID：

fastn serve --api_key YOUR_API_KEY --space_id YOUR_WORKSPACE_ID

💻 使用示例

基础用法

macOS/Linux

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

Windows

C:\path\to\your\uv.exe --directory C:\path\to\your\fastn-server run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_WORKSPACE_ID

✨ 主要特性

• 支持与多种 AI 工具集成，方便在不同场景下使用。
• 提供详细的日志记录功能，日志格式为：

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

📚 详细文档

分步设置指南

Fastn 设置

1. 访问 https://app.fastn.ai 创建账户，获取 API Key 和 Workspace ID。

服务器安装

使用包安装

uv pip install fastn

手动安装

克隆仓库后运行以下命令：

git clone https://github.com/yourusername/fastn.git
cd fastn
poetry install

配置文件示例

macOS/Linux

{
  "mcp.servers": {
    "fastn": {
      "type": "command",
      "cmd": "/path/to/your/uv run fastn-server.py",
      "args": [
        "--api_key",
        "YOUR_API_KEY",
        "--space_id",
        "YOUR_WORKSPACE_ID"
      ]
    }
  }
}

Windows

{
  "mcp.servers": {
    "fastn": {
      "type": "command",
      "cmd": "\"C:\\path\\to\\your\\uv.exe\" --directory C:\\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 文件，添加：

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

2. 安装依赖项：

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

📄 许可证

项目采用 LICENSE 协议。

🔗 支持与文档

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