优化内存 MCP 服务器 v2

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

概述

此 MCP 服务器实现重点关注：

• 大规模基础设施跟踪的高效内存管理

• 遵循 MCP 模式的综合资源和工具实施

• 完全兼容 Claude Desktop

• 基于 SQLite 的持久存储与连接池

• 强大的错误处理和资源清理

特征

• MCP 资源

  • 实体管理（列表、检索、关系）

  • 提供商资源跟踪

  • Ansible 集合管理

  • 版本跟踪

  • 全文搜索功能

• MCP 工具

  • 实体创建和管理

  • 观察追踪

  • 提供商注册

  • Ansible 模块集成

  • 基础设施分析工具

• 核心组件

  • FastMCP 服务器实现

  • 具有连接池的 SQLite 数据库

  • 全面的错误处理

  • 自动资源清理

  • 广泛的日志记录

项目结构

要求

• 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桌面：

   • 将 MCP 服务器 URL 设置为http://localhost:8000

   • 在 Claude 设置中启用 MCP 协议

3. 验证连接：

   curl http://localhost:8000/health

开发设置

1. 安装开发依赖项：

   pip install -r requirements-dev.txt

2. 设置预提交钩子：

   pre-commit install

3. 运行测试：

   pytest

4. 检查代码质量：

   flake8 mypy .

贡献

1. 分叉存储库

2. 创建功能分支

3. 按照我们的惯例进行更改

4. 运行测试和 linting

5. 提交拉取请求

文档

• 环境设置指南- 安装和配置

• MCP 使用指南- 使用 MCP 资源和工具

• API 文档- API 参考

• 配置指南-服务器配置

• 开发指南- 贡献指南

• 数据库模式- 数据模型参考

• 故障排除指南- 常见问题和解决方案

执照

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

致谢

• Claude Desktop 团队制定 MCP 协议规范

• FastMCP 库的贡献者

• SQLAlchemy 数据库工具团队