项目简介

MXCP是一个专为企业级AI应用设计的Model Context Protocol (MCP) 服务器框架。它不仅仅是简单的MCP实现，而是提供了一套完整的生产就绪方法论，包括数据建模、服务设计、智能实现、质量保障和生产运维。

主要功能

• 多种实现方式：支持SQL查询和Python复杂逻辑，可根据需求选择最适合的工具
• 企业级安全：内置OAuth认证、RBAC权限控制和策略执行
• 完整审计追踪：记录所有操作，满足合规要求
• 类型安全：全面的SQL和Python数据验证
• 测试框架：单元测试、集成测试和LLM行为测试
• 性能优化：异步支持、查询优化和缓存策略
• 漂移检测：监控跨环境的模式变更
• OpenTelemetry集成：分布式追踪和生产可观测性
• dbt集成：原生数据转换支持
• 质量保障：验证、测试、代码检查和LLM评估

安装步骤

# 基础安装
pip install mxcp

# 可选功能安装
pip install "mxcp[vault]"         # HashiCorp Vault集成
pip install "mxcp[onepassword]"   # 1Password集成
pip install "mxcp[all]"           # 所有可选功能

# 创建新项目
mkdir my-ai-tools && cd my-ai-tools
mxcp init --bootstrap

服务器配置

将以下配置添加到Claude Desktop的配置文件中：

{
  "mcpServers": {
    "my-tools": {
      "command": "mxcp",
      "args": ["serve", "--transport", "stdio"],
      "cwd": "/path/to/my-ai-tools"
  }
}

配置说明：

• my-tools：MCP服务器名称，可自定义
• command：服务器启动命令，使用"mxcp"
• args：启动参数，包括服务模式("serve")和传输协议("stdio")
• cwd：项目根目录路径，确保工具和资源文件可访问

基本使用方法

# 启动MCP服务器
mxcp serve

# 验证项目结构
mxcp validate

# 测试所有端点
mxcp test

# 列出可用端点
mxcp list