Fastapply MCP

🚀 FastApply MCP Server

FastApply MCP Serverは、現代の開発チーム向けのエンタープライズグレードのコードインテリジェンスプラットフォームです。ローカルAIモデル、ASTベースのセマンティック検索、エンタープライズセキュリティ機能、およびインテリジェントパターン認識を組み合わせた高度なアーキテクチャを通じて、包括的なコード分析、検索、および変換機能を提供します。

🚀 クイックスタート

これらの簡単な手順で、5分以内にFastApplyを起動しましょう。

1. インストール

# FastApplyをクローンしてインストール
git clone https://github.com/your-org/fastapply-mcp.git
cd fastapply-mcp

# uvを使用して依存関係をインストール（推奨）
uv sync --all-extras
source .venv/bin/activate
uv pip install -e .

# またはpipを使用する場合
pip install -e .
cp .env.example .env

✅ グレースフルデグレーデーション：欠落しているオプションの依存関係は、自動的に情報を提供しながら機能を低下させます。

2. 設定

.env ファイルでFastApplyサーバーを設定します。

# FastApplyのコア設定
FAST_APPLY_URL=http://localhost:1234/v1        # あなたのFastApplyサーバーのURL
FAST_APPLY_MODEL=fastapply-1.5b                # モデル識別子
FAST_APPLY_TIMEOUT=30.0                        # リクエストのタイムアウト時間

# パフォーマンス最適化
FAST_APPLY_MAX_TOKENS=8000                     # レスポンスのトークン制限
FAST_APPLY_TEMPERATURE=0.05                    # モデルの一貫性

# セキュリティと隔離
WORKSPACE_ROOT=/path/to/project                # ワークスペースの制限
FAST_APPLY_STRICT_PATHS=1                      # パスの検証
MAX_FILE_SIZE=10485760                         # 10MBのファイル制限

3. MCP統合

Claude Codeとの統合：

{
  "mcpServers": {
    "fast-apply-mcp": {
      "command": "uvx",
      "args": ["--from", "/path/to/fastapply-mcp", "run", "python", "main.py"]
    }
  }
}

4. 起動と検証

# FastApplyサーバーがアクセス可能かを確認
curl http://localhost:1234/v1/models

# Claude Codeを再起動してMCPサーバーを読み込む
# これでFastApplyツールが利用可能になりました！

🎯 成功：FastApplyが統合され、開発ワークフローを強化する準備ができました！

✨ 主な機能

• ローカルモデルアーキテクチャ：Kortix/FastApply-1.5B-v1.0_GGUF を通じて、MorphLLMのような edit_file 機能を使用します。
• ASTベースのセマンティック検索：ast-grep（ローカルインストール）を通じて、高度なコードパターンマッチングと構造分析を行います。
• 行指向の検索：ripgrep（ローカルインストール）を通じて、ディレクトリを再帰的に検索して正規表現パターンを見つけます。
• Qdrant MCPメモリストレージ：Qdrant MCP Server を通じて、高度なセマンティック検索と永続的な共有メモリをサポートします。
• 多言語サポート：Python、JavaScript、TypeScript、Javaで動作します。
• エンタープライズ機能：セキュリティスキャン、コンプライアンスレポート、自動化された品質ゲートを提供します。
• 開発者統合：MCP、Claude Code、および主要なIDEと互換性があります。
• パフォーマンス重視：MorphLLMを使用した高速なセマンティック検索と効率的なキャッシュ。
• 拡張可能な設計：プラグインベースで、オプション機能のフォールバックをサポートします。

🎯 主要な機能

📦 インストール

FastApplyをインストールするには、以下の手順に従います。

# FastApplyをクローンしてインストール
git clone https://github.com/your-org/fastapply-mcp.git
cd fastapply-mcp

# uvを使用して依存関係をインストール（推奨）
uv sync --all-extras
source .venv/bin/activate
uv pip install -e .

# またはpipを使用する場合
pip install -e .
cp .env.example .env

💻 使用例

基本的な使用法

// AIガイド付きのリファクタリングと検証
{
  "tool": "edit_file",
  "arguments": {
    "target_file": "src/auth.js",
    "instructions": "Add input validation and error handling",
    "code_edit": "function login(email, password) {\n  if (!email || !password) {\n    throw new Error('Email and password are required');\n  }\n  \n  try {\n    return await authenticateUser(email, password);\n  } catch (error) {\n    throw new Error(`Authentication failed: ${error.message}`);\n  }\n}"
  }
}

高度な使用法

// エラーハンドリングを持つすべての非同期関数を検索
{
  "tool": "search_code_patterns",
  "arguments": {
    "pattern": "async function $name($args) { $body }",
    "language": "javascript",
    "path": "src"
  }
}

// コード構造と複雑性を分析
{
  "tool": "analyze_code_structure",
  "arguments": {
    "file_path": "src/api/user-service.ts"
  }
}

// コードベース全体でシンボル参照を追跡
{
  "tool": "find_references",
  "arguments": {
    "symbol": "UserRepository",
    "path": "src",
    "symbol_type": "class"
  }
}

📚 ドキュメント

📖 コアドキュメント

• ユーザーガイド - 完全なユーザードキュメントとチュートリアル
• APIリファレンス - 包括的なAPIドキュメント
• アーキテクチャガイド - 詳細なアーキテクチャ分析
• 設定ガイド - セットアップと設定オプション

🛠️ 技術ドキュメント

• 実装リファレンス - 技術的な実装詳細
• セキュリティドキュメント - セキュリティ機能とコンプライアンス
• パフォーマンスガイド - パフォーマンス最適化とチューニング
• 統合ガイド - 統合パターンと例

🚀 デプロイメントと運用

• デプロイメントガイド - 本番環境でのデプロイメント手順
• 監視とロギング - 運用監視とロギング
• スケーリングガイド - 水平スケーリングと負荷分散
• トラブルシューティングガイド - 一般的な問題と解決策

🔧 技術詳細

システムアーキテクチャ

┌─────────────────────────────────────────────────────────────────┐
│                   FastApply MCP Server                         │
├─────────────────────────────────────────────────────────────────┤
│  🎯 エントリーポイント: main.py (オーケストレーション)       │
│                                                                 │
│  🔍 検索レイヤー - 他のアプローチより750%高速               │
│  ├── ripgrep_integration.py (高性能検索)                       │
│  └── enhanced_search.py (複数戦略検索)                        │
│                                                                 │
│  🧠 インテリジェンスレイヤー - AI強化分析                  │
│  ├── ast_rule_intelligence.py (LLM推論)                        │
│  ├── ast_search.py (カスタムAST分析)                           │
│  └── deep_semantic_analysis.py (パターン認識)                 │
│                                                                 │
│  🔗 分析と操作 - エンタープライズグレードのツール             │
│  ├── symbol_operations.py (シンボル検出)                      │
│  ├── relationship_mapping.py (依存関係分析)                    │
│  ├── navigation_tools.py (コードナビゲーション)               │
│  ├── security_quality_analysis.py (セキュリティと品質)         │
│  └── safe_refactoring.py (安全な変換)                          │
│                                                                 │
│  ⚡ 処理と統合 - 拡張可能なバックエンド                    │
│  ├── batch_operations.py (バルク処理)                         │
│  └── main.py (MCPサーバーオーケストレーション)              │
└─────────────────────────────────────────────────────────────────┘

コアアーキテクチャの原則

📄 ライセンス

MITライセンス - 詳細は LICENSE ファイルを参照してください。

🎯 ライセンスの概要

• ✅ 商用利用：商用アプリケーションでの使用が可能です。
• ✅ 修正：ソフトウェアを修正および適応させることができます。
• ✅ 配布：修正内容を配布することができます。
• ✅ 私的利用：制限なく私的に使用することができます。
• ❗ 保証：「現状のまま」で提供され、保証はありません。
• ❗ 責任：作者は損害に対して責任を負いません。