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