Grigori

🚀 Grigori

Grigori 是一款桌面應用程序，用於管理編碼上下文，AI 助手可通過 MCP（模型上下文協議）訪問這些上下文。它能幫助你以結構化的方式定義和組織編碼標準、架構模式以及開發偏好。

🚀 快速開始

前提條件

• .NET 10 SDK
• 支持 Windows、macOS 或 Linux（通過 MAUI）

構建與運行

# 克隆倉庫
git clone https://github.com/andres-m-rodriguez/Grigori.git
cd Grigori

# 構建項目
dotnet build

# 運行桌面應用
dotnet run --project src/Grigori.Desktop

從 Claude Code 連接

將以下內容添加到你的 Claude Code MCP 設置中：

{
  "mcpServers": {
    "grigori": {
      "url": "http://localhost:3001/sse"
    }
  }
}

✨ 主要特性

編碼上下文

• 編碼模式：記錄你常用的編碼模式（例如“倉庫模式”“CQRS”）。
• 設計偏好：定義你的編碼風格選擇，並說明理由和優先級。
• 避免規則：指定要避免的模式和實踐，並設置嚴重級別。

架構上下文

• 架構模式：使用 ASCII 圖定義分層架構。
• 層依賴關係：指定層之間允許和禁止的依賴關係。
• 代碼模板：帶有佔位符的可複用代碼模板，用於搭建項目框架。
• 命名約定：記錄不同上下文（如 DTO、倉庫等）的命名模式。

MCP 集成

• 內置 MCP 服務器，提供 40 多種用於讀寫上下文的工具。
• 可從 Claude Code、Cursor 或任何兼容 MCP 的客戶端進行連接。
• AI 助手在幫助你編碼時可以查詢你的編碼標準。

📦 安裝指南

按照上述“快速開始”部分的步驟進行安裝和配置。

💻 使用示例

基礎用法

# 克隆倉庫
git clone https://github.com/andres-m-rodriguez/Grigori.git
cd Grigori

# 構建項目
dotnet build

# 運行桌面應用
dotnet run --project src/Grigori.Desktop

高級用法

在 Claude Code 中配置 MCP 連接：

{
  "mcpServers": {
    "grigori": {
      "url": "http://localhost:3001/sse"
    }
  }
}

📚 詳細文檔

MCP 工具

編碼上下文工具

架構上下文工具

🔧 技術細節

項目結構

src/
├── Grigori.Desktop/        # MAUI Blazor Hybrid 桌面應用
│   ├── Components/         # Blazor 頁面和組件
│   └── Mcp/               # MCP 服務器集成
├── Grigori.Contracts/      # DTO 和倉庫接口
├── Grigori.DataAccess/     # 倉庫實現
├── Grigori.Database/       # EF Core DbContext 和模型
└── Grigori.Common.Pagination/  # 基於遊標分頁

技術棧

• .NET 10：最新的 .NET 運行時。
• MAUI Blazor Hybrid：跨平臺桌面 UI。
• MudBlazor：Material Design 組件庫。
• SQLite：本地數據庫存儲。
• Entity Framework Core：ORM。
• MinimalMcp：MCP 服務器實現。
• BlazingSingularity：異步命令狀態管理。

📄 許可證

本項目採用 MIT 許可證。

🔗 導出

設置頁面包含導出功能，可從你的編碼上下文中生成 CLAUDE.md 格式的文件，適用於不使用 MCP 的項目。