使用说明
AvaloniaUI.MCP 翻译为中文可以是:“AvaloniaUI 的 MCP(可能是指某种模块、组件或配置文件,具体需根据上下文确定)”。不过,由于“MCP”在没有具体上下文的情况下可能有多种含义,所以这里的翻译保留了“MCP”以表示其可能是一个特定的术语或缩写。如果“MCP”在特定上下文中有明确的含义,如“Multi-Component Protocol”、“Module Configuration Package”等,则应根据具体含义进行翻译
适用于AvaloniaUI开发的专业模型上下文协议服务器
一个全面的MCP服务器,为企业级跨平台AvaloniaUI应用程序的开发提供工具、资源和指导。
🚀 特点
🛠️(扳手或工具的图标,无具体文字对应,可理解为“工具”或“修理”等含义) 15+ 开发工具
- 项目生成 - MVVM(模型-视图-视图模型)、基础模板和跨平台模板
- XAML 验证 - 语法检查和最佳实践强制执行
- 安全模式 - 安全的身份验证和数据保护
- 性能分析 - 优化指导与监控
- 迁移支持 - 完整的WPF到AvaloniaUI转换协助
📚 书籍或学习资料的象征 庞大的知识库
- 500+ 控件 - 完整的AvaloniaUI控件参考
- 设计模式 - MVVM(模型-视图-视图模型)、响应式编程和架构指导
- 最佳实践 - 行业标准的开发实践
- 代码示例 - 现实世界中的实施实例
🔒(锁形符号,常用于表示安全、保密或锁定状态) 企业功能
- 遥测与监控 - 实时性能指标和健康检查
- 缓存系统 - 智能资源缓存,实现80%以上的命中率
- 输入验证 - 全面的参数验证和清理
- 错误处理 - 优雅的错误处理,附带有用的诊断信息
- 审计日志记录 - 完整的操作追踪和合规支持
⚡(闪电符号,常用于表示速度、能量、惊喜或警告等含义,具体翻译需根据上下文确定) 高性能
- < 100毫秒响应时间 - 为生产工作负载进行了优化
- 异步操作 - 非阻塞文件和网络操作
- 内存高效 - 轻松占用空间,实现智能资源管理
- 并发支持 - 同时处理多个请求
📖 快速入门
先决条件
- .NET 9.0 SDK 或之后
- 与MCP兼容的客户端 (Claude Desktop,带有MCP扩展的VS Code)
安装
# Clone the repository
git clone https://github.com/decriptor/AvaloniaUI.MCP.git
cd AvaloniaUI.MCP
# Build the project
dotnet build
# Run tests (optional)
dotnet test
# Start the server
dotnet run --project src/AvaloniaUI.MCP/AvaloniaUI.MCP.csproj
配置
在您的MCP客户端配置中添加:
{
"mcpServers": {
"avalonia": {
"command": "dotnet",
"args": [
"run",
"--project",
"/path/to/AvaloniaUI.MCP/src/AvaloniaUI.MCP/AvaloniaUI.MCP.csproj"
],
"cwd": "/path/to/AvaloniaUI.MCP"
}
}
}
首批命令
在您的MCP客户端中尝试以下命令:
"Create a new AvaloniaUI MVVM project called MyApp"
"Validate this XAML code for best practices"
"Generate JWT authentication pattern with high security"
"Show me how to migrate this WPF control to AvaloniaUI"
"Perform a health check on the server"
🛠️ 工具概览
| 类别 | 工具 | 描述 |
|---|---|---|
| (无对应中文) | (无对应中文) | (无对应中文) |
| 项目生成工具,架构模板工具 | 创建遵循最佳实践的完整项目 | ** |
| Xaml验证工具,安全模式工具,无障碍工具 | 确保代码质量和安全性 | ** |
| 主题工具(ThemingTool)、自定义控件生成器(CustomControlGenerator)、动画工具(AnimationTool) | 构建美观、交互式的界面 | ** |
| API集成工具、本地化工具、数据访问模式工具 | 与外部系统集成 | ** |
| 诊断工具、测试集成工具、性能分析工具 | 监控和优化应用程序 | 📚 书籍或学习的象征 完整的工具文档
→
📊 性能指标 | 指标 | 值 | 描述 | |--------|--------|-------------| | 响应时间 | < 100ms | 平均工具执行时间 | | 测试覆盖率 | 90%+ | 全面的测试套件 | | 缓存命中率 | 80%+ | 资源缓存效率 | | 内存使用量 | < 200MB | 典型的内存占用 | | 并发用户
| 50+ | 支持同时连接 |
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ MCP Client │ │ AvaloniaUI.MCP │ │ Knowledge Base │
│ (Claude, VSC) │◄──►│ Server │◄──►│ (JSON Files) │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│
▼
┌──────────────────┐
│ Tool Ecosystem │
│ • Project Gen │
│ • Validation │
│ • Security │
│ • Diagnostics │
└──────────────────┘
🏗️ 建筑学
- 构建于: .NET 9.0
- - 最新运行时,具备性能优化 MCP协议
- - 官方微软模型上下文协议SDK OpenTelemetry(开放遥测技术)
- - 企业可观测性和监控 反应式扩展
- 异步/响应式编程模式
📚 文档 | 资源 | 描述 | |----------|-------------| | 📖 文档网站 | 完整的文档及示例 | | 🚀 快速入门指南 | 5分钟内开始跑步 | | 🛠️ 工具参考 | 详细的工具文档 | | 💡 示例与教程 | 实际应用示例 | | 🐞 故障排除
| 常见问题及解决方案 |
🧪 测试
# Run all tests
dotnet test
# Run with coverage
dotnet test --collect:"XPlat Code Coverage"
# Run specific categories
dotnet test --filter Category=Unit
dotnet test --filter Category=Integration
包含150多个测试的综合测试套件:
- 测试类别: 单元测试
- - 单个部件测试 集成测试
- - 工具交互测试 性能测试
- - 负载和响应时间测试 安全测试
- 输入验证和安全模式测试
🔒 安全
- 企业级安全功能: 输入验证
- - 所有参数均经过严格模式验证 安全模式
- - 防御性安全模式生成 审计日志记录
- - 完整的操作追踪 错误处理
- - 未暴露敏感信息 资源限制
- 防止资源耗尽
🌍 贡献 我们欢迎投稿!请参阅我们的 贡献指南
详情如下。
- 开发环境设置 分支并克隆
- 存储库安装依赖项
dotnet restore - **:**运行测试
dotnet test - **:**创建特性分支
git checkout -b feature/amazing-feature - : 做出改变
- 附带测试
提交拉取请求
- 贡献领域
- 🛠️ 新工具和功能
- 📚 文档改进
- 🐞 错误修复和优化
- 🧪 更全面的测试覆盖
🌐 国际化支持
📄 许可证 这个项目采用MIT许可证授权——详见 许可证
文件中有详细信息。
- 🙏 致谢 AvaloniaUI 团队
- - 用于出色的跨平台用户界面框架 微软
- - 对于模型上下文协议规范 贡献者
- - 所有帮助改进这个项目的人 社区
- 用于反馈、错误报告和功能请求
Built with ❤️ for the AvaloniaUI community
🌟 Star us on GitHub • 🐛 Report issues • 🤝 Contribute • 📖 Read the docs