MCP Revenue Demo

演示MCP服务器

🚀 运行服务器

标准模式

poetry run uvicorn app.main:app --reload

生产模式

poetry run uvicorn app.main:app --host 0.0.0.0 --port 8000

服务器将在 http://localhost:8000 上启动

🔧 Claude Desktop/MCP 客户端配置

使用mcp-remote（推荐）

首先，启动服务器：

poetry run uvicorn app.main:app --host 0.0.0.0 --port 8000

然后配置您的MCP客户端：

适用于 macOS: ~/Library/Application Support/Claude/claude_desktop_config.json\ 适用于Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "payment-revenue-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8000/mcp"
      ]
    }
  }
}

重要提示： 在启动 Claude Desktop 之前，请确保服务器正在运行！

💡 与Claude的使用示例

配置完成后，您可以向Claude提出自然语言问题：

示例1：本月收入

你： “这个月的总收入是多少？”

克劳德将使用： get_revenue_this_month()

示例2：年度至今分析

你： “给我看看到目前为止的年度收入”

克劳德将使用： get_revenue_year_to_date()

示例3：特定时间窗口

你： “上星期一上午10点到中午12点之间的收入是多少？”

克劳德将使用： get_revenue_custom_range(start_date="2024-10-07T10:00:00", end_date="2024-10-07T12:00:00")

示例4：类别细分

你： “按产品类别细分本月的收入”

克劳德将使用： get_revenue_by_category(start_date="2024-10-01", end_date="2024-10-31")

示例5：过去30天

你： “我们过去30天里产生了多少收入？”

克劳德将使用： get_revenue_last_n_days(days=30)

示例6：月度对比

你： “给我展示2024年的月度收入”

克劳德将使用： get_revenue_by_month(year=2024)

🧪 测试服务器

访问 http://localhost:8000/docs 以交互式测试所有端点。