使用说明

项目简介

本项目 'mcp-server' 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为大型语言模型（LLM）客户端提供丰富的外部数据和功能接口。它通过标准化的 MCP 协议与客户端通信，支持工具注册和调用，以及资源管理。本服务器集成了多种实用工具，包括法律信息查询、天气数据获取、Azure 服务价格查询和中文文本处理等，旨在扩展 LLM 的能力边界，使其能够访问和利用更广泛的信息资源。

主要功能点

法律信息查询工具：
- 查询中国刑法条文信息（按条文号）
- 根据关键词搜索相关刑法条文
- 根据罪名或条文名称查询法律信息
- 获取指定条文的具体段落内容
- 获取中国刑法全文
天气和实用工具：
- 获取美国州级天气警报
- 根据经纬度获取天气预报
- 使用 OData 过滤器查询 Azure 服务价格
- 中文字符计数

安装步骤

克隆仓库

git clone https://github.com/xuhaodev/mcp-server
cd mcp-server

创建并激活虚拟环境

python -m venv venv
source venv/bin/activate   # Linux/macOS
# venv\Scripts\activate  # Windows

安装依赖

pip install -r requirements.txt

服务器配置

MCP 客户端需要配置 MCP 服务器的连接信息才能与之通信。对于本 'mcp-server'，客户端需要配置服务器的启动命令 (command) 及其参数 (args)。以下是一个 JSON 格式的配置示例，用于配置名为 "my-mcp-server" 的服务器：

{
  "servers": {
    "my-mcp-server": {
      "command": "python",
      "args": ["mcp-server.py", "--host", "0.0.0.0", "--port", "8080"],
      "transport": "sse"
    }
  }
}

配置参数说明:

'server name': 服务器名称，例如 "my-mcp-server"，客户端使用此名称引用服务器。
'command': 启动服务器的命令，这里使用 'python' 解释器。
'args': 传递给启动命令的参数列表。
- '"mcp-server.py"': 指定运行 'mcp-server.py' 文件。
- '"--host", "0.0.0.0"': 指定服务器监听所有网络接口（允许从外部访问）。
- '"--port", "8080"': 指定服务器监听端口为 8080。
'transport': 指定通信协议为 'sse' (Server-Sent Events)。

注意: MCP 客户端需要能够执行 'python' 命令并访问 'mcp-server.py' 文件所在的目录。请根据您的 MCP 客户端的具体配置方法进行配置。

基本使用方法

启动服务器 在项目根目录下，运行以下命令启动 MCP 服务器：
```
python mcp-server.py --host 0.0.0.0 --port 8080
```
服务器将在 'http://localhost:8080/sse' 提供 Server-Sent Events 接口，用于 MCP 客户端连接。
使用工具 启动服务器后，MCP 客户端可以通过 MCP 协议与服务器通信，并调用服务器提供的工具。例如，可以使用自然语言指令指示 LLM 客户端调用工具来查询法律条文、获取天气信息或进行其他操作。

工具调用示例:
- 查询刑法条文: “请查找刑法第133条的内容。”
- 查询天气警报: “纽约州有天气警报吗？”
- 统计中文字符数: “请数一下 ‘人工智能正在改变我们的生活方式。’ 这句话里有多少个中文字符。”
具体的工具调用方式和参数需要参考 MCP 客户端的文档和工具的描述信息。

关键词