.net Code Context

🚀 NetContext上下文服務器

NetContext上下文服務器是一款提供代碼倉庫上下文的工具，支持通過命令行訪問。它藉助實現模型上下文協議 (MCP)，讓AI編程助手能更精準地生成和協助編寫代碼，還具備可配置忽略模式與敏感文件安全保護機制。

🚀 快速開始

基本操作

1. 設置基目錄：

dotnet run --project src/NetContextClient.csproj -- set-base-dir --directory "D:\Projects\MyApp"

2. 檢查版本和配置：

dotnet run --project src/NetContextClient.csproj -- version

其他操作示例

• 添加自定義忽略模式：

dotnet run --project src/NetContextClient.csproj -- add-ignore-patterns --patterns "*.generated.cs" "*.designer.cs"

• 列出所有項目：

dotnet run --project src/NetContextClient.csproj -- list-projects-in-dir --directory "D:\Projects\MyApp\src"

• 分析依賴項：

dotnet run --project src/NetContextClient.csproj -- analyze-packages

• 搜索代碼：

dotnet run --project src/NetContextClient.csproj -- semantic-search --query "user authentication and authorization logic"

✨ 主要特性

• 代碼索引：支持語義搜索，基於代碼含義查找相關內容。
• 上下文提供：通過MCP協議為AI工具提供完整的項目上下文。
• 忽略模式：可自定義文件和目錄的忽略規則。
• 安全保護：內置敏感文件保護機制。

📦 安裝指南

1. 克隆倉庫：git clone https://github.com/your-repository.git
2. 安裝依賴：.NET SDK 7.0+ 已預裝依賴
3. 啟動服務：dotnet run --project NetContextServer.csproj

📚 詳細文檔

與AI編程工具的集成

NetContextServer實現了MCP協議，支持以下工具：

• VS Code：配置VS Code使用NetContextServer作為MCP提供商。
• 其他符合MCP標準的工具。

配置VS Code

1. 打開設置界面。
2. 配置AI助手使用NetContextServer地址。

安全特性

1. 路徑安全：僅允許訪問基目錄內的文件。
2. 模式驗證：忽略模式語法正確性檢查。
3. 大小限制：大文件內容自動截斷以防止內存溢出。
4. 敏感文件保護：內置模式保護常見敏感文件類型。

示例工作流程

1. 設置基目錄：

dotnet run --project src/NetContextClient.csproj -- set-base-dir --directory "D:\Projects\MyApp"

2. 檢查服務器版本和配置：

dotnet run --project src/NetContextClient.csproj -- version

3. 添加自定義忽略模式：

dotnet run --project src/NetContextClient.csproj -- add-ignore-patterns --patterns "*.txt" "*.log"

4. 列出所有項目：

dotnet run --project src/NetContextClient.csproj -- list-projects-in-dir --directory "D:\Projects\MyApp\src"

5. 分析依賴項：

dotnet run --project src/NetContextClient.csproj -- analyze-packages

錯誤處理

常見錯誤

1. 找不到基目錄：確保路徑正確且存在。
2. 未安裝 .NET SDK：安裝最新版 .NET SDK (7.0+)。
3. 權限問題：檢查文件夾權限，確保有讀取權限。

貢獻指南

1. 提交代碼前，請確保通過單元測試。
2. 代碼格式遵循C#編碼規範。
3. 提交PR前，請閱讀貢獻準則文檔。

📄 許可證

項目使用MIT許可證，具體條款請參考 LICENSE 文件。

文檔聯繫方式

如有任何問題，請聯繫：your.email@example.com

更多詳細信息，請訪問項目主頁：https://github.com/your-repository