# 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)