Fastapply MCP

🚀 FastApply MCP Server

FastApply MCP Server 是為現代開發團隊打造的企業級代碼智能平臺，它通過結合本地 AI 模型、基於 AST 的語義搜索、企業安全特性和智能模式識別的複雜架構，提供全面的代碼分析、搜索和轉換功能。

項目徽章

🚀 為什麼選擇 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 實現快速語義搜索和高效緩存。
• 可擴展設計：基於插件，支持可選功能的回退。

✨ 主要特性

📦 安裝指南

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 已集成並準備好提升你的開發工作流程！

💻 使用示例

基礎用法

📁 智能代碼編輯

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

🛡️ 企業安全分析

// 全面的安全審計
{
  "tool": "security_scan_comprehensive",
  "arguments": {
    "project_path": "/path/to/project",
    "scan_types": ["pattern", "dependencies", "configuration"],
    "compliance_standards": ["owasp_top_10", "pci_dss"],
    "output_format": "json"
  }
}

📊 質量評估

// 多維度質量分析
{
  "tool": "quality_assessment_comprehensive",
  "arguments": {
    "project_path": "/path/to/project",
    "analysis_types": ["complexity", "code_smells", "maintainability"],
    "output_format": "json"
  }
}

🧠 AI 增強智能

// 帶有集體記憶的深度語義分析
{
  "tool": "llm_analyze_code",
  "arguments": {
    "code": "function processData(data) { /* ... */ }",
    "language": "javascript",
    "analysis_type": "security",
    "use_collective_memory": true
  }
}

高級用法

🏗️ 大規模重構

// 帶有依賴分析的安全重構
{
  "tool": "llm_search_pattern",
  "arguments": {
    "query": "find all references to legacy UserService class",
    "language": "java",
    "path": "./src/main/java",
    "use_collective_memory": true
  }
}

🛡️ 企業安全審計

// 帶有合規報告的全面安全掃描
{
  "tool": "security_scan_comprehensive",
  "arguments": {
    "project_path": "./payment-system",
    "scan_types": ["pattern", "dependencies", "configuration"],
    "compliance_standards": ["owasp_top_10", "pci_dss", "soc2"],
    "output_format": "json"
  }
}

📊 質量門控自動化

// 多維度質量評估
{
  "tool": "quality_assessment_comprehensive",
  "arguments": {
    "project_path": ".",
    "analysis_types": ["complexity", "code_smells", "maintainability", "test_coverage"],
    "quality_thresholds": {
      "complexity_score": 15,
      "maintainability_index": 70
    },
    "output_format": "json"
  }
}

🏗️ 架構分析

// 深度架構分析
{
  "tool": "llm_analyze_code",
  "arguments": {
    "code": "monolith_codebase_context",
    "language": "multi",
    "analysis_type": "architecture",
    "use_collective_memory": true,
    "focus_areas": ["dependencies", "coupling", "boundaries"]
  }
}

📚 文檔生成

// 自動化文檔生成
{
  "tool": "search_code_patterns",
  "arguments": {
    "pattern": "function $name($args) { $body }",
    "language": "python",
    "path": "./api/endpoints",
    "extract_metadata": ["docstrings", "type_hints", "examples"]
  }
}

📚 詳細文檔

📖 核心文檔

• 用戶指南 - 完整的用戶文檔和教程
• API 參考 - 全面的 API 文檔
• 架構指南 - 詳細的架構分析
• 配置指南 - 設置和配置選項

🛠️ 技術文檔

• 實現參考 - 技術實現細節
• 安全文檔 - 安全特性和合規性
• 性能指南 - 性能優化和調優
• 集成指南 - 集成模式和示例

🚀 部署與操作

• 部署指南 - 生產部署說明
• 監控與日誌 - 運營監控和日誌記錄
• 擴展指南 - 水平擴展和負載均衡
• 故障排除指南 - 常見問題和解決方案

🔧 技術細節

🏗️ 架構概述

FastApply 實現了一個複雜的多層架構，旨在實現可擴展性、性能和企業可靠性。

📊 系統架構

┌─────────────────────────────────────────────────────────────────┐
│                   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 服務器編排)                        │
└─────────────────────────────────────────────────────────────────┘

🎯 核心架構原則

⚡ 性能基準

FastApply 通過優化算法和智能緩存系統提供企業級性能。

📈 搜索性能

💾 內存效率

🚀 併發與可擴展性

• 默認操作：4 個併發進程（可配置至 16 個）
• 批量處理：1000+ 文件，即時進度監控
• 請求處理：100+ 併發 MCP 請求
• 水平擴展：支持多個服務器實例

🎯 緩存系統

• 緩存命中率：重複搜索的命中率達 85% 以上
• 內存緩存：1000 個條目，智能 LRU 淘汰
• 磁盤緩存：持久存儲，可配置 TTL
• 智能失效：基於文件系統事件的緩存更新
• 跨會話：服務器重啟後持久緩存

🔧 配置選項

🌍 環境配置

# === 核心服務器設置 ===
HOST=localhost                                    # 服務器主機綁定
PORT=8000                                       # 服務器端口
DEBUG=false                                     # 調試模式
LOG_LEVEL=INFO                                  # 日誌詳細程度

# === FastApply 集成 ===
FAST_APPLY_URL=http://localhost:1234/v1         # FastApply 服務器 URL
FAST_APPLY_MODEL=fastapply-1.5b                 # 模型標識符
FAST_APPLY_API_KEY=optional-key                 # 可選 API 密鑰
FAST_APPLY_TIMEOUT=30.0                         # 請求超時時間
FAST_APPLY_MAX_TOKENS=8000                      # 最大響應令牌數
FAST_APPLY_TEMPERATURE=0.05                     # 模型創造力

# === 性能優化 ===
MAX_CONCURRENT_OPERATIONS=4                     # 併發操作數
CACHE_SIZE=1000                                 # 緩存條目限制
TIMEOUT_SECONDS=30                              # 操作超時時間

# === 安全與隔離 ===
WORKSPACE_ROOT=/safe/workspace                  # 工作區限制
FAST_APPLY_STRICT_PATHS=1                      # 路徑驗證
MAX_FILE_SIZE=10485760                          # 10MB 文件限制
ALLOWED_EXTENSIONS=.py,.js,.ts,.jsx,.tsx,.md,.json,.yaml,.yml

# === 可選集成 ===
OPENAI_API_KEY=your-openai-key                 # OpenAI 集成
QDRANT_URL=http://localhost:6333               # Qdrant 向量數據庫
QDRANT_API_KEY=your-qdrant-key                 # Qdrant API 密鑰

🎯 支持的 FastApply 服務器

🔄 集成模式

FastApply 可無縫集成到現代開發工作流程和工具鏈中。

💻 Claude Code 集成

{
  "mcpServers": {
    "fast-apply-mcp": {
      "command": "uvx",
      "args": ["--from", "/path/to/fastapply-mcp", "run", "python", "main.py"],
      "env": {
        "FAST_APPLY_URL": "http://localhost:1234/v1",
        "FAST_APPLY_MODEL": "fastapply-1.5b",
        "WORKSPACE_ROOT": "/path/to/project"
      }
    }
  }
}

🚀 CI/CD 管道集成

# GitHub Actions - 自動化質量門控
name: Code Quality & Security Check
on: [push, pull_request]

jobs:
  quality-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: 設置 FastApply
        run: |
          pip install fastapply-mcp
          fastapply-mcp --install

      - name: 安全掃描
        run: |
          fastapply-mcp security-scan --path . --output security-report.json

      - name: 質量評估
        run: |
          fastapply-mcp quality-assess --path . --output quality-report.json

      - name: 生成合規報告
        run: |
          fastapply-mcp compliance-report --standards owasp_top_10,pci_dss

🛠️ IDE 與編輯器集成

🔧 API 集成

# Python API 集成
from fastapply import FastApplyClient

client = FastApplyClient(
    url="http://localhost:1234/v1",
    model="fastapply-1.5b"
)

# 安全掃描
results = client.security_scan(
    project_path="./src",
    scan_types=["pattern", "dependencies"]
)

# 質量分析
quality = client.quality_assessment(
    project_path="./src",
    analysis_types=["complexity", "maintainability"]
)

🛡️ 企業安全與合規

🔍 漏洞檢測

📋 合規框架支持

🏗️ 安全架構

🚨 安全特性

• 即時掃描：持續檢測漏洞
• 自動化報告：生成合規報告
• 自定義規則：創建組織特定的安全策略
• 集成就緒：無縫集成到現有安全工具鏈中
• 審計跟蹤：完整的操作歷史記錄，滿足合規要求

🎯 實際用例

FastApply 改變了不同行業和團隊規模的開發工作流程。

🔄 1. 大規模重構

場景：對 500K+ 行代碼的企業代碼庫進行現代化改造

// 帶有依賴分析的安全重構
{
  "tool": "llm_search_pattern",
  "arguments": {
    "query": "find all references to legacy UserService class",
    "language": "java",
    "path": "./src/main/java",
    "use_collective_memory": true
  }
}

影響：手動重構時間減少 90%，零生產事故

🛡️ 2. 企業安全審計

場景：對金融服務應用進行季度安全評估

// 帶有合規報告的全面安全掃描
{
  "tool": "security_scan_comprehensive",
  "arguments": {
    "project_path": "./payment-system",
    "scan_types": ["pattern", "dependencies", "configuration"],
    "compliance_standards": ["owasp_top_10", "pci_dss", "soc2"],
    "output_format": "json"
  }
}

影響：自動化合規報告，識別 40 個關鍵漏洞

📊 3. 質量門控自動化

場景：開發團隊的 CI/CD 管道集成

// 多維度質量評估
{
  "tool": "quality_assessment_comprehensive",
  "arguments": {
    "project_path": ".",
    "analysis_types": ["complexity", "code_smells", "maintainability", "test_coverage"],
    "quality_thresholds": {
      "complexity_score": 15,
      "maintainability_index": 70
    },
    "output_format": "json"
  }
}

影響：代碼質量指標提高 60%，自動化部署決策

🏗️ 4. 架構分析

場景：微服務遷移規劃

// 深度架構分析
{
  "tool": "llm_analyze_code",
  "arguments": {
    "code": "monolith_codebase_context",
    "language": "multi",
    "analysis_type": "architecture",
    "use_collective_memory": true,
    "focus_areas": ["dependencies", "coupling", "boundaries"]
  }
}

影響：確定清晰的遷移策略，遷移風險降低 30%

📚 5. 文檔生成

場景：醫療平臺的 API 文檔

// 自動化文檔生成
{
  "tool": "search_code_patterns",
  "arguments": {
    "pattern": "function $name($args) { $body }",
    "language": "python",
    "path": "./api/endpoints",
    "extract_metadata": ["docstrings", "type_hints", "examples"]
  }
}

影響：幾分鐘內生成完整的 API 文檔，覆蓋率 100%

🚀 成功指標

🔧 故障排除與支持

🚨 常見問題與解決方案

🔌 連接問題

# 驗證 FastApply 服務器是否可訪問
curl http://localhost:1234/v1/models

# 檢查 MCP 服務器配置
echo "MCP Configuration:"
cat ~/.config/claude-code/mcp_servers.json

# 測試服務器連接
python -c "
import requests
try:
    response = requests.get('http://localhost:1234/v1/models', timeout=5)
    print('✅ FastApply 服務器可訪問')
except Exception as e:
    print(f'❌ 連接失敗: {e}')
"

⚡ 性能問題

# 啟用調試日誌進行性能分析
export LOG_LEVEL=DEBUG
export DEBUG=true

# 監控資源使用情況
top -p $(pgrep -f fastapply)

# 清除緩存並重啟
rm -rf ./cache/*
python -m fastapply.main --restart

# 檢查內存使用情況
python -c "
import psutil
import os
process = psutil.Process(os.getpid())
print(f'內存使用: {process.memory_info().rss / 1024 / 1024:.1f}MB')
"

🛡️ 安全與權限問題

# 驗證工作區配置
echo "工作區根目錄: $WORKSPACE_ROOT"

# 檢查文件權限
ls -la /path/to/workspace

# 驗證路徑解析
python -c "
from fastapply.main import _secure_resolve
print('測試路徑解析:', _secure_resolve('/test'))
"

# 審計安全設置
python -c "
import os
print('安全設置:')
print(f'嚴格路徑: {os.getenv("FAST_APPLY_STRICT_PATHS", "0")}')
print(f'最大文件大小: {os.getenv("MAX_FILE_SIZE", "10485760")}')
"

🔍 高級調試

全面調試模式

# 啟用完整調試
export LOG_LEVEL=DEBUG
export DEBUG=true
export FAST_APPLY_DEBUG=1

# 啟動並輸出調試信息
python -m fastapply.main --debug --verbose

# 即時監控日誌
tail -f fastapply.log

健康檢查系統

# 全面健康檢查
python -c "
import asyncio
import json
from fastapply.main import health_check

async def full_health_check():
    print('🔍 正在進行全面健康檢查...')

    # 基本健康檢查
    health = await health_check()
    print(f'📊 健康狀態: {health}')

    # MCP 連接檢查
    try:
        import mcp
        print('✅ MCP 模塊可用')
    except ImportError:
        print('❌ MCP 模塊缺失')

    # FastApply 連接檢查
    try:
        import openai
        client = openai.OpenAI(base_url='http://localhost:1234/v1')
        models = client.models.list()
        print('✅ FastApply 服務器已連接')
    except Exception as e:
        print(f'❌ FastApply 連接失敗: {e}')

asyncio.run(full_health_check())
"

性能分析

# 性能分析
python -c "
import time
import cProfile
import pstats

def profile_fastapply():
    # 分析啟動時間
    start = time.time()

    # 這裡是你的 FastApply 操作

    end = time.time()
    print(f'操作完成時間: {end-start:.2f}s')

# 運行性能分析
profiler = cProfile.Profile()
profiler.enable()
profile_fastapply()
profiler.disable()

# 保存性能分析統計信息
stats = pstats.Stats(profiler)
stats.sort_stats('cumulative')
stats.print_stats(10)
"

📋 常見錯誤解決方法

🤝 社區支持

• GitHub 問題：報告錯誤和請求功能
• 社區討論：參與討論
• 文檔：完整指南
• 示例：實際實現

🤝 貢獻代碼

我們歡迎並鼓勵社區貢獻！FastApply 依賴於社區的參與和協作而蓬勃發展。

🚀 如何貢獻

1. 開始

# 分叉並克隆倉庫
git clone https://github.com/your-username/fastapply-mcp.git
cd fastapply-mcp

# 設置開發環境
uv sync --all-extras --dev
source .venv/bin/activate

# 安裝預提交鉤子
pre-commit install

2. 開發工作流程

# 創建功能分支
git checkout -b feature/amazing-feature

# 進行更改並編寫測試
# 為新功能更新文檔

# 運行質量檢查
ruff check .
ruff format .
mypy src/

# 運行測試
pytest
pytest --cov=src/ --cov-report=html:htmlcov/ --cov-report=term-missing

# 提交更改
git commit -m "feat: add amazing feature with comprehensive tests"

# 推送並創建 PR
git push origin feature/amazing-feature

3. 貢獻指南

🏗️ 開發架構

┌─────────────────────────────────────────────────────────────────┐
│                   開發環境                     │
├─────────────────────────────────────────────────────────────────┤
│  📁 src/fastapply/          # 核心源代碼                 │
│  📁 tests/                   # 全面的測試套件         │
│  📁 docs/                    # 文檔                   │
│  📁 examples/                # 實際使用示例         │
│  📁 .github/                 # CI/CD 工作流                 │
│  📁 scripts/                 # 開發實用工具           │
└─────────────────────────────────────────────────────────────────┘

🧪 測試框架

# 運行所有測試
pytest -v

# 運行並生成覆蓋率報告
pytest --cov=src/ --cov-report=html:htmlcov/ --cov-report=term-missing

# 運行特定測試類別
pytest -m unit          # 僅運行單元測試
pytest -m integration   # 僅運行集成測試
pytest -m performance   # 僅運行性能測試
pytest -m security      # 僅運行安全測試

# 運行並開啟調試
pytest -vvs --tb=short  # 詳細輸出，短回溯

📝 文檔標準

• API 文檔：完整的文檔字符串，帶有類型提示
• 使用示例：所有功能的可運行代碼示例
• 架構文檔：清晰的設計原理和模式
• 遷移指南：版本升級說明
• 故障排除：常見問題和解決方案

🎯 貢獻領域

功能開發

• 新的分析工具和功能
• 更多語言支持
• 性能優化
• 安全增強

文檔

• 用戶指南和教程
• API 參考改進
• 最佳實踐文檔
• 視頻教程和演示

測試與質量

• 擴展測試覆蓋率
• 性能基準測試
• 安全測試
• 錯誤修復和改進

🏆 認可與感謝

• 貢獻者名人堂：在 README 和文檔中得到認可
• 發佈說明：在版本更新中被提及
• 社區認可：在討論和公告中被突出顯示
• 周邊獎勵：為重大貢獻提供商品獎勵

📋 行為準則

請閱讀並遵守我們的 行為準則，以確保為所有貢獻者營造一個友好和包容的環境。

📄 許可證

MIT 許可證 - 詳情請參閱 LICENSE 文件。

🎯 許可證摘要

• ✅ 商業使用：可用於商業應用
• ✅ 修改：可修改和調整軟件
• ✅ 分發：可分發你的修改版本
• ✅ 私人使用：可無限制地私人使用
• ❗ 保修：按“原樣”提供，無保修
• ❗ 責任：作者對損害不承擔責任

🏆 企業支持

💼 專業支持選項

📞 聯繫選項

• GitHub 問題：報告錯誤和請求功能
• 社區討論：參與討論
• 企業銷售：聯繫我們 獲取自定義解決方案
• 安全問題：私下報告安全漏洞

🌟 社區資源

• 文檔：完整的指南和 API 參考
• 示例：實際使用示例和模板
• 博客：最新功能和最佳實踐
• 時事通訊：產品更新和社區亮點

🚀 準備開始了嗎？

立即使用 AI 驅動的代碼智能改變你的開發工作流程！

🎯 快速路徑

💡 下一步

1. 🔧 安裝 FastApply - 幾分鐘內即可啟動並運行
2. 📚 探索文檔 - 學習高級功能和模式
3. 🤝 加入社區 - 與其他開發者建立聯繫
4. 🏢 部署到生產環境 - 在整個組織中擴展使用