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

✨ 主要特性

• 支持与多种 AI 工具集成，方便用户在不同的 AI 环境中高效工作。
• 提供详细的日志记录功能，日志格式如下：

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

📦 安装指南

服务器安装

使用包安装

uv pip install fastn

手动安装

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

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

💻 使用示例

基础用法

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

📚 详细文档

配置文件示例

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

分步设置指南

Fastn 设置

1. 访问 https://app.fastn.ai 创建账户并获取 API Key 和 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