Classic Models MCP

经典型号MCP服务器

将Claude Desktop连接到经典型号API的MCP服务器\ 提供37个工具，用于管理产品、客户、订单等。

______________________________________________________________________

🚀 快速开始

只需3个步骤即可开始跑步：

# 1. Install dependencies
pip install -r requirements.txt

# 2. Configure (optional - uses defaults)
# Edit .env file or set environment variables

# 3. Run the server
python -m src.server

下一页： 连接克劳德桌面 开始使用这些工具。

______________________________________________________________________

✨ 这有什么作用

此MCP服务器充当以下各项之间的桥梁 克劳德桌面 和那个 API经典型号，使您可以访问：

• 📦 产品 -管理产品目录
• 👥 客户 -处理客户记录
• 📋 订单 -处理和跟踪订单
• 🏢 办公室 -管理办公地点
• 👔 员工 -员工管理
• 💰 支付 -付款跟踪
• 还有更多。..

总共37个工具 涵盖了8种资源类型的所有CRUD操作。

______________________________________________________________________

📋 目录

• 安装
• 配置
• 运行服务器
• 连接克劳德桌面
• 可用工具
• 文档
• 发展

______________________________________________________________________

📦 安装

需求

• Python 3.12+ - 下载Python
• API经典型号 -本地或远程运行

- 当地： http://localhost:8000 - 远程： https://qnap-jiri.myqnapcloud.com

再进行

选项1：使用虚拟环境（推荐）

# Create virtual environment
python3.12 -m venv venv

# Activate virtual environment
# On macOS/Linux:
source venv/bin/activate
# On Windows:
# venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

选项2：全局安装

pip install -r requirements.txt

选项3：使用 uv （更快）

uv pip install -r requirements.txt

💡 提示： 在运行服务器或测试之前，始终激活虚拟环境！

______________________________________________________________________

⚙️ 配置

环境变量

创建一个 .env 项目根目录中的文件：

# API Connection
CLASSIC_MODELS_API_URL=http://localhost:8000

# HTTP Server (for remote access)
HTTP_PORT=3000
HTTP_BEARER_TOKEN=your-secret-token-here

# Transport Mode
TRANSPORT=stdio  # or "http"

# API Credentials (optional - defaults to demo/demo123)
API_USERNAME=demo
API_PASSWORD=demo123

配置选项

💡 提示： 对于开发，您可以跳过 .env 默认文件运行良好！

______________________________________________________________________

🏃 运行服务器

选项1：原生Python（推荐用于开发）

stdio模式 （本地，默认）：

python -m src.server

HTTP模式 （远程访问）：

TRANSPORT=http python -m src.server

选项2:Docker（推荐用于生产环境）

快速启动：

docker-compose up -d classic-models-mcp-http

完整指南：

______________________________________________________________________

🔌 连接克劳德桌面

快速设置（stdio）

1. 打开克劳德桌面配置：

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json - Linux： ~/.config/Claude/claude_desktop_config.json

1. 添加此配置：

   {
     "mcpServers": {
       "classic-models": {
         "command": "python3.12",
         "args": ["-m", "src.server"],
         "env": {
           "CLASSIC_MODELS_API_URL": "http://localhost:8000",
           "TRANSPORT": "stdio"
         },
         "cwd": "/absolute/path/to/classic-models-mcp"
       }
     }
   }

1. 重新启动克劳德桌面

📖 完整指南： Claude桌面配置

______________________________________________________________________

🛠️ 可用工具

服务器提供 37工具 按资源组织：

工具命名模式

所有工具都遵循此模式： classic_models_{operation}_{resource}

示例：

• classic_models_list_products -获取所有产品
• classic_models_get_product -获取一个产品
• classic_models_create_product -添加新产品
• classic_models_update_product -修改产品
• classic_models_delete_product -删除产品

📖 完整参考： 工具文档

______________________________________________________________________

📚 文档

所有文件均在 docs/ 文件夹：

______________________________________________________________________

🔗 API 参考

此MCP服务器连接到 API经典型号:

• 存储库： jiridj/经典模型api
• 本地API架构： http://localhost:8000/classic-models/api/schema/
• 公共API架构： https://qnap-jiri.myqnapcloud.com/classic-models/api/schema/

______________________________________________________________________

💻 发展

项目结构

classic-models-mcp/
├── src/
│   ├── server.py          # Main MCP server entry point
│   ├── config.py          # Configuration management
│   ├── api/
│   │   ├── client.py      # HTTP client for API calls
│   │   ├── auth.py        # JWT authentication
│   │   └── types.py       # Type definitions
│   └── tools/             # MCP tool implementations
│       ├── products.py
│       ├── customers.py
│       └── ... (6 more)
├── docs/                  # Documentation
├── requirements.txt       # Python dependencies
└── README.md             # This file

添加新工具

1. 在中创建工具文件 src/tools/
2. 跟随 工具文档指南
3. 注册 src/server.py
4. 更新 docs/TOOLS.md

代码的风格

• Python 3.12+类型提示
• 异步/等待API调用
• 综合文档字符串（参见 工具文档指南)
• 错误处理和验证

______________________________________________________________________

❓ 获取帮助

• 文档： 检查 docs/ 文件夹
• API问题： 经典模型API存储库
• MCP服务器问题： 在此存储库中打开问题

______________________________________________________________________

📄 许可证

MIT许可证-有关详细信息，请参阅许可证文件

______________________________________________________________________

🙏 致谢

• 内置于 FastMCP
• 连接到 API经典型号
• 使用经典模型教程数据库