Abside (Caletti Gabriele)

Abside

IDE架构蓝图系统

一个模块化的MCP（模型上下文协议）生态系统，帮助开发人员和LLM应用设计模式并编写更好的代码。

______________________________________________________________________

📋 目录

• 概述
• 建筑
• MCP服务器
• 安装
• 快速开始
• 配置
• 发展
• 贡献
• 许可证

🎯 概述

Abside是MCP（模型上下文协议）服务器系列，旨在通过直接在IDE中提供智能架构指导、设计模式建议和代码质量改进来增强开发体验。

主要特点

• 🏗️ 模块化架构：每台服务器都专注于软件开发的一个特定方面
• 🔌 MCP协议：与AI驱动的IDE和工具无缝集成
• 📚 图案库：全面收集设计模式和最佳实践
• 🤖 人工智能原生：专为LLM辅助开发工作流程而构建
• 🔧 可扩展：易于添加新的服务器和功能

🏛️ 建筑

Abside遵循微服务启发的架构，其中每个MCP服务器都是一个独立的专用组件：

┌─────────────────────────────────────────────────────────┐
│                      IDE / Client                        │
└─────────────────────────────────────────────────────────┘
                           │
                           │ MCP Protocol
                           │
        ┌──────────────────┼──────────────────┐
        │                  │                  │
┌───────▼────────┐ ┌──────▼───────┐ ┌───────▼────────┐
│  Pattern       │ │  Architecture │ │   Quality      │
│  Server        │ │  Server       │ │   Server       │
└────────────────┘ └──────────────┘ └────────────────┘
        │                  │                  │
        └──────────────────┴──────────────────┘
                           │
                    Shared Libraries

🖥️ MCP服务器

可用服务器

服务器功能

每个MCP服务器提供：

• 资源：访问模式库、文档和知识库
• 工具：用于代码分析和转换的可执行函数
• 提示词：常见开发任务的预配置提示

📦 安装

先决条件

• Python 3.8或更高版本
• pip或uv包管理器
• 兼容MCP的IDE或客户端

从源代码安装

# Clone the repository
git clone https://github.com/CalettiGabriele/Abside.git
cd Abside

# Create a virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -e .

使用uv进行安装

uv pip install -e .

🚀 快速开始

1.配置IDE

将Abside服务器添加到MCP客户端配置中（例如。， claude_desktop_config.json):

{
  "mcpServers": {
    "abside-pattern": {
      "command": "python",
      "args": ["-m", "abside.servers.pattern"],
      "cwd": "/path/to/Abside"
    }
  }
}

2.开始使用Abside

配置后，您可以通过AI助手与Abside交互：

"Show me the Singleton pattern implementation"
"Analyze this code for SOLID principle violations"
"Suggest an architectural pattern for this microservice"

⚙️ 配置

每个服务器都可以通过环境变量或配置文件进行配置：

# .env file
ABSIDE_PATTERN_LIBRARY_PATH=/path/to/patterns
ABSIDE_LOG_LEVEL=INFO
ABSIDE_CACHE_ENABLED=true

有关具体的配置选项，请参阅单个服务器文档。

🛠️ 发展

项目结构

Abside/
├── src/
│   └── abside/
│       ├── servers/          # Individual MCP servers
│       │   ├── pattern/
│       │   ├── architecture/
│       │   └── quality/
│       ├── common/           # Shared utilities
│       └── patterns/         # Pattern library
├── tests/                    # Test suite
├── docs/                     # Documentation
├── examples/                 # Usage examples
└── README.md

运行测试

# Run all tests
pytest

# Run with coverage
pytest --cov=abside --cov-report=html

添加新服务器

1. 在下创建新目录 src/abside/servers/
2. 实现MCP服务器接口
3. 添加服务器配置
4. 编写测试
5. 更新文档

看 贡献.md 详细指南。

🤝 贡献

欢迎投稿！请阅读我们的 贡献指南 在提交PR之前。

开发环境设置

# Install development dependencies
pip install -e ".[dev]"

# Install pre-commit hooks
pre-commit install

# Run linting
ruff check .

# Format code
ruff format .

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

• 模型上下文协议 对于MCP规范
• 开源社区提供灵感和支持

📞 联系

• 作者加布里埃尔·卡莱蒂
• 仓库:
• 问题:

______________________________________________________________________