🚀 优化内存 MCP 服务器 v2

这是一个基于 Python 的高性能模型上下文协议 (MCP) 服务器实现，专门为 Claude Desktop 集成进行了优化。该服务器具备高效的内存管理能力和强大的基础组件跟踪功能。

🚀 快速开始

请参阅我们的 环境搭建指南 获取详细安装说明。

关键步骤如下：

1. 克隆代码并设置 Python 环境。
2. 安装依赖：pip install -r requirements.txt。
3. 配置数据库：export DATABASE_URL=sqlite:///path/to/db.db。
4. 初始化数据库：alembic upgrade head。
5. 启动服务器：uvx run python -m src.main。

✨ 主要特性

项目概述

此 MCP 服务器实现侧重于以下方面：

• 针对大规模基础设施跟踪实现高效的内存管理。
• 实现符合 MCP 模式的资源和工具。
• 完全兼容 Claude Desktop。
• 采用带有连接池的 SQLite 进行基础持久化存储。
• 具备强大的错误处理和资源清理能力。

具体功能

MCP 资源

• 实体管理（列表、检索、关系）。
• 提供程序资源跟踪。
• Ansible 收集管理。
• 版本跟踪。
• 全文搜索功能。

MCP 工具

• 实体创建和管理。
• 观察跟踪。
• 提供程序注册。
• Ansible 模块集成。
• 基础设施分析工具。

核心组件

• FastMCP 服务器实现。
• 带有连接池的 SQLite 数据库。
• 全面的错误处理。
• 自动资源清理。
• 详细的日志记录。

项目结构

.
├── src/
│   ├── resources/          # MCP 资源实现
│   ├── tools/             # MCP 工具实现
│   ├── db/                # 数据库管理
│   ├── utils/             # 工具函数
│   └── server.py          # 主服务器实现
├── tests/
│   ├── resources/         # 资源测试
│   ├── tools/             # 工具测试
│   └── integration/       # 集成测试
├── docs/                  # 文档
├── migrations/            # 数据库迁移
└── requirements/          # 项目依赖

项目要求

• Python 3.13.1 或更高版本。
• SQLite 3.x。
• uvx 服务器。

💻 使用示例

基础用法

启动服务器

uvx run python -m src.main

配置 Claude Desktop

• 设置 MCP 服务器 URL 为 http://localhost:8000。
• 在 Claude 设置中启用 MCP 协议。

验证连接

curl http://localhost:8000/health

开发设置

安装开发依赖

pip install -r requirements-dev.txt

设置预提交钩子

pre-commit install

运行测试

pytest tests/

格式化代码

black .

📚 详细文档

• 环境搭建指南 - 点击查看
• 使用指南 - 点击查看
• 开发指南 - 点击查看
• 测试指南 - 点击查看

📄 许可证

文档中未提及相关信息。

⚠️ 重要提示

该项目已存档，因为项目规范和 AI 方向存在缺陷，导致无限循环行为。