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