项目简介

这是一个简单的 MCP（Model Context Protocol）服务器实现，专注于提供一个特定的功能：查询江苏大学部分区域宿舍的电费信息。它通过注册一个 MCP 工具来实现这一功能，允许兼容 MCP 协议的 LLM 客户端调用该工具获取数据。

主要功能点

• 提供电费查询工具： 注册一个名为 'get_room_bill_tool' 的 MCP 工具。
• 查询外部服务： 通过调用外部 API 获取江苏大学宿舍的电费余额和相关信息。
• MCP 标准兼容： 使用 'fastmcp' 库构建，遵循 MCP 协议进行通信和工具注册。
• Stdio 传输： 默认使用 Stdio 协议进行数据传输。

安装步骤

要运行此 MCP 服务器，您需要安装 Python 以及所需的库：

1. 克隆或下载项目代码到本地目录。
2. 打开终端或命令行工具，进入项目所在的目录。
3. 安装所需的 Python 库 'requests' 和 'fastmcp'：

   pip install requests fastmcp
   

服务器配置 (供 MCP 客户端参考)

MCP 客户端需要配置如何启动并连接到这个服务器进程。典型的配置信息包括服务器名称、启动命令、命令参数以及通信方式。对于此服务器，您需要告知客户端：

• 服务器名称 (server name): <code>ujs-mcp-server</code>
• 启动命令 (command): 您的 Python 解释器路径 (例如：<code>python</code> 或 <code>python3</code>)
• 命令参数 (args): 服务器脚本 'bill_query.py' 的文件路径 (例如：<code>["/path/to/your/bill_query.py"]</code>)
• 通信方式 (transport): <code>stdio</code>

具体如何配置取决于您使用的 MCP 客户端。

基本使用方法

一旦 MCP 客户端成功连接并启动此服务器进程，LLM 客户端就可以通过 MCP 协议发现并调用名为 'get_room_bill_tool' 的工具。

调用该工具时，需要提供一个名为 'room' 的字符串参数。这个参数应为宿舍号的后三位数字（例如，对于 F7 区四楼 417 宿舍，参数应为 '"417"'）。

工具执行后，将返回一个字符串，其中包含查询的宿舍地址、当前电费余额以及查询时间。

请注意： 代码中的外部 API 请求 headers 和 cookies 可能需要更新才能正常工作。