优化的内存 MCP 服务器 v2

一个基于 Python 的高性能模型上下文协议 (MCP) 服务器实现，针对 Claude Desktop 集成进行了优化。该服务器提供高效的内存管理和强大的基础设施组件跟踪能力。

[!CAUTION] 由于存在缺陷的项目规范和导致无限循环行为的 AI 指导，此项目已被存档。

概述

此 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 服务器

快速开始

请参阅我们的 环境设置指南 以获取详细的安装说明。

主要步骤：

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

用法

1. 启动服务器：

   uvx run python -m src.main
   

2. 配置 Claude Desktop：

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

3. 验证连接：

   curl http://localhost:8000/health
   

开发设置

1. 安装开发依赖项：

   pip install -r requirements-dev.txt
   

2. 设置 pre-commit 钩子：

   pre-commit install
   

3. 运行测试：

   pytest
   

4. 检查代码质量：

   flake8
   mypy .
   

贡献

1. Fork 存储库
2. 创建一个功能分支
3. 按照我们的约定进行更改
4. 运行测试和 linting
5. 提交 pull request

文档

• 环境设置指南 - 安装和配置
• MCP 使用指南 - 使用 MCP 资源和工具
• API 文档 - API 参考
• 配置指南 - 服务器配置
• 开发指南 - 贡献指南
• 数据库模式 - 数据模型参考
• 故障排除指南 - 常见问题和解决方案

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• Claude Desktop 团队提供的 MCP 协议规范
• FastMCP 库的贡献者
• SQLAlchemy 团队提供的数据库工具