# ID Factory MCP Server
一个基于 Model Context Protocol (MCP) 的 ID Factory 解析服务器，提供统一的 ID 句柄解析和查询功能。
## 功能特性
- **单个ID解析** - 解析ID句柄获取详细信息
- **批量解析** - 同时解析多个ID句柄
- **组件分析** - 解析并格式化ID组件信息
- **完整响应数据** - 包括站点信息、归属信息、权限设置等
## 安装
### 使用 pip
```bash
pip install mcp
```
### 使用 uv (推荐)
```bash
uv pip install mcp
```
## 快速开始
### 方式1: 直接运行
```bash
python idfactory_mcp_server.py
```
### 方式2: 使用包管理器
```bash
# 安装
pip install -e .
# 运行
idfactory-mcp-server
```
## MCP 配置
在 Claude Code 的配置文件中添加：
```json
{
"mcpServers": {
"idfactory": {
"command": "python",
"args": ["/path/to/idfactory_mcp_server.py"],
"env": {}
}
}
}
```
## 使用示例
```bash
# 解析单个ID
请帮我解析ID句柄 700.100
# 批量解析
批量解析这些ID：700.100, 700.1, 700.2
# 组件分析
详细解析ID 700.100的所有组件信息
```
## API 端点
- **Base URL**: `http://resolve.idfactory.cn:8081`
- **无需认证**：公开API，无需密钥
## 工具列表
| 工具名 | 描述 | 参数 |
|--------|------|------|
| `resolve_id` | 解析ID获取详细信息 | `handle` (必需) |
| `batch_resolve_ids` | 批量解析多个ID句柄 | `handles` (必需, 数组) |
| `parse_id_components` | 解析并格式化ID组件 | `handle` (必需), `format_output` (可选) |
## 项目结构
```
.
├── idfactory_mcp_server/ # 包目录
│ ├── __init__.py
│ └── server.py # MCP服务器实现
├── idfactory_mcp_server.py # 单文件版本
├── pyproject.toml # 项目配置
├── requirements.txt # 依赖列表
└── README.md # 本文档
```
## 开发
### 运行测试
```bash
python test_idfactory.py
```
### 调试模式
```bash
# 启用详细日志
LOGLEVEL=DEBUG python idfactory_mcp_server.py
```
## 依赖
- Python >= 3.10
- mcp >= 1.0.0
## License
MIT License
## 作者
yshumei098
## 相关链接
- [ID Factory API](http://resolve.idfactory.cn:8081)
- [MCP 协议规范](https://modelcontextprotocol.io)
