内容
# 贵金属 MCP 服务器
印尼贵金属（logam mulia）价格的 MCP 服务器，来源于 18+ 个数据源。
**源 API:** [logam-mulia-api](https://github.com/iamutaki/logam-mulia-api)
## 快速开始
```bash
# 直接运行（从仓库）
uv run python -m logam_mulia_mcp.server
```
```bash
# 从 PyPI 运行（无需克隆，无需安装）
uvx logam-mulia-mcp
```
## MCP 工具
| 工具 | 描述 |
|------|-------------|
| `get_price(source, refresh?)` | 从源获取最新价格 |
| `get_price_history(source, page?, length?, weight?, material?, material_type?)` | 分页历史记录 |
| `list_sources()` | 所有 18 个可用源 |
| `get_all_prices()` | 一次获取所有源的最新价格 |
| `get_news()` | 最新黄金新闻文章 |
| `get_news_detail(url)` | 完整文章文本 |
## 配置
| 环境变量 | 默认值 | 描述 |
|-----|---------|-------------|
| `LOGAM_MULIA_BASE_URL` | `https://logam-mulia-api.iamutaki.workers.dev` | API 基地址 |
| `MCP_TRANSPORT` | `stdio` | 传输方式：`stdio` 或 `sse` |
| `HTTP_TIMEOUT` | `30` | HTTP 客户端超时（秒） |
## 集成
### Claude 代码 / Cursor / 任意 MCP 主机（通过 uvx）
添加到您的 `claude_desktop_config.json` 或 `.cursor/mcp.json`：
```json
{
"mcpServers": {
"logam-mulia": {
"command": "uvx",
"args": ["logam-mulia-mcp"]
}
}
}
```
**可选：自定义 API 基地址**
```json
{
"mcpServers": {
"logam-mulia": {
"command": "uvx",
"args": ["logam-mulia-mcp"],
"env": {
"LOGAM_MULIA_BASE_URL": "https://your-proxy.example.com"
}
}
}
}
```
无需安装，无需克隆。`uvx` 自动从 PyPI 获取。
### Hermes
```yaml
tools:
mcp_servers:
logam-mulia:
command: uvx
args:
- logam-mulia-mcp
# env: # 可选自定义基地址
# LOGAM_MULIA_BASE_URL: https://your-proxy.example.com
```
### 直接（任意 shell）
```bash
# 使用默认 API
pip install -e .
logam-mulia-mcp
# 使用自定义 API 基地址
LOGAM_MULIA_BASE_URL=https://your-proxy.example.com logam-mulia-mcp
```
