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 の設定ファイル例

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

高度な使用法

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

🔧 トラブルシューティング

パッケージ構造のエラー

以下のエラーが発生した場合：

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"
   

サポートとドキュメント

• ドキュメント：https://docs.fastn.ai
• コミュニティサポート：https://community.fastn.ai

📄 ライセンス

このプロジェクトは LICENSE ライセンスの下で提供されています。