模型上下文协议服务器

真实世界演示服务器

一个功能强大的模型上下文协议（MCP）服务器 FastMCP 展示了真实世界的功能，包括系统监控、SQLite数据库交互和UUID生成。

特性

• 系统监控：实时跟踪CPU、内存和磁盘使用情况，以及进程监控。
• 数据库集成：内置SQLite数据库(commerce.db)用产品和订单模拟电子商务平台。
• 公用事业：现代UUID生成。
• AI提示：预配置的提示可帮助LLM分析数据。

快速开始

先决条件

• Python 3.10或更高版本
• 紫外线 （推荐）

安装

1. 安装依赖项：
   复制

   uv add mcp psutil
   

   或者使用pip：
   复制

   pip install mcp psutil
   

初始化

初始化示例数据库：

# Using uv
uv run setup_db.py

# Or using python directly
python setup_db.py

运行服务器

启动MCP服务器：

# Using uv
uv run server.py

# Or using python directly
python server.py

配置

要将此服务器与Claude Desktop一起使用，请将以下内容添加到您的 claude_config.json:

{
  "mcpServers": {
    "RealWorldDemo": {
      "command": "uv",
      "args": [
        "--directory",
        "c:\\...",
        "run",
        "server.py"
      ]
    }
  }
}

工具和模式

read_sqlite_query

对本地商务数据库执行SELECT查询。

• 输入架构:

  复制

  {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "The SQL SELECT query to execute"
      }
    },
    "required": ["query"]
  }
  

• 输出模式: List[Dict[str, Any]]

  复制

  [
    {
      "column_name": "value",
      ...
    }
  ]
  

get_system_metrics

返回实时系统指标。

• 输入架构: {} （无争议）
• 输出模式:
  复制

  {
    "cpu_percent": 12.5,
    "memory": {
      "total": 17179869184,
      "available": 8589934592,
      "percent": 50.0,
      "used": 8589934592,
      "free": 8589934592
    },
    "disk": {
      "total": 499963174912,
      "used": 200000000000,
      "free": 299963174912,
      "percent": 40.0
    },
    "timestamp": "2023-10-27T10:00:00.123456"
  }
  

generate_uuid_v7

生成一个现代的、按时间顺序排列的UUID。

• 输入架构: {} （无争议）
• 输出模式: String （例如。， "018b7796-6b2a-7c98-8e3f-123456789abc")

资源

system://processes

按CPU使用率返回前10个正在运行的进程。

• 统一资源标识符: system://processes
• mime类型: application/json
• 模式:
  复制

  [
    {
      "pid": 1234,
      "name": "python.exe",
      "cpu_percent": 5.2,
      ...
    }
  ]
  

db://schema

返回商务数据库的架构。

• 统一资源标识符: db://schema
• mime类型: text/plain
• 内容：SQL CREATE TABLE 声明。

提示

sql_analyst

AI SQL分析师帮助编写商业数据库查询的上下文。

• 参数:
  • question：用户关于数据的问题。
• 用法：当您想问“最畅销的产品是什么？”或“显示最近的订单”等问题时，请使用此提示

数据库模式

服务器使用SQLite数据库 commerce.db 具有以下结构：

products

orders