内容
# MCP_TO_PC_ENTITIES
一个 MCP (机器通信协议) 项目,能够查询 DNO API 以获取目录实体和定价规则。
## 特性
- 从不同运营商获取优惠、产品和服务
- 从不同运营商检索定价规则
## 设置
1. 克隆代码库
2. 安装依赖:
```bash
# 安装 uv 包管理器 (macOS)
brew install uv
# 使用 uv 安装项目依赖
uv pip install -r requirements.txt
```
3. 创建一个 `.env` 文件,包含以下变量:
```
DNO_HOST=your_dno_host
DNO_TOKEN_KEY_ID=your_key_id
DNO_TOKEN_KEY=your_secret_key
```
4. 在 Claude Desktop 中进行配置:
- 从 [Claude Desktop Downloads](https://claude.ai/desktop) 下载 Claude Desktop
- 配置文件位置:
- macOS: `~/Library/Application Support/Claude Desktop/config.json`
```bash
# 使用 VS Code 打开
code ~/Library/Application\ Support/Claude\ Desktop/config.json
# 或使用任何文本编辑器
open -t ~/Library/Application\ Support/Claude\ Desktop/config.json
```
- Windows: `%APPDATA%\Claude Desktop\config.json`
```cmd
notepad %APPDATA%\Claude Desktop\config.json
```
- Linux: `~/.config/Claude Desktop/config.json`
```bash
# 使用默认编辑器打开
xdg-open ~/.config/Claude\ Desktop/config.json
```
在你的 Claude Desktop 配置文件中添加以下内容:
```json
{
"mcpServers": {
"@modelcontextprotocol-server-local-api": {
"command": "/path/to/uv",
"args": [
"--directory",
"/path/to/project",
"run",
"dno_api.py"
]
}
}
}
```
注意:将 `/path/to/uv` 和 `/path/to/project` 替换为你的实际路径
## 使用
该项目提供了多个函数与 DNO API 进行交互:
- `get_offers(operator_name, entity_type)`: 获取目录实体(优惠/产品/服务)
- `get_pricing_rules(operator_name)`: 获取定价规则
服务器使用 FastMCP 进行通信。
## Claude 聊天互动
在 Claude Desktop 中配置完成后,你可以通过 Claude 聊天使用自然语言与 DNO API 进行交互。以下是一些示例互动:
- "获取运营商 X 的所有优惠"
- "获取运营商 Y 的定价规则"
- "展示运营商 Z 可用的产品"
Claude 将自动使用适当的 API 端点并为你处理身份验证。

## 需求
- Python 3.x
- `requirements.txt` 中列出的依赖
- 有效的 DNO API 凭证
## 许可证
有关详细信息,请参见 [LICENSE](LICENSE) 文件。