open-index/open-npm huggingface dataset:
npm package: @mcpcn/mcp-ip-query
Description: IP Query MCP Server
Latest version: 1.0.6

# IP Query MCP

这是一个基于 Model Context Protocol (MCP) 的 IP 地址查询服务，提供 IP 地址查询功能。

## 功能特点

- **查询当前IP地址**：获取当前设备的公共 IP 地址及其地理位置信息。
- **查询指定IP地址**：获取指定 IP 地址的地理位置信息。

## 环境配置

> 注意：您需要拥有阿里云 IP 地址查询 API 的密钥才能使用此服务。请将密钥配置为环境变量 `ALIYUN_IP_API_KEY`。

## 使用方法

```json
{
  "mcpServers": {
    "mcp-server/ip-query": {
      "command": "node",
      "args": [
        "index.js" 
      ],
      "env": {
        "ALIYUN_IP_API_KEY": "您的阿里云IP API密钥"
      },
      "autoApprove": [
        "get_my_ip",
        "get_ip_location"
      ]
    }
  }
}
```

### 工具功能

该 MCP 提供以下工具：

1. **查询当前IP地址** (`get_my_ip`)
   - 输入：无
   - 输出：当前IP地址及其地理位置信息

2. **查询指定IP地址** (`get_ip_location`)
   - 输入：IP 地址 (字符串, 例如: "8.8.8.8")
   - 输出：指定IP地址的地理位置信息

## 示例

### 查询当前IP地址示例

调用工具:
```json
{
  "name": "get_my_ip",
  "arguments": {}
}
```

预期输出 (示例):
```json
{
  "ip": "114.114.114.114",
  "pro": "江苏省",
  "proCode": "320000",
  "city": "南京市",
  "cityCode": "320100",
  "region": "",
  "regionCode": "0",
  "addr": "江苏省南京市 电信",
  "regionNames": "",
  "err": ""
}
```

### 查询指定IP地址示例

调用工具:
```json
{
  "name": "get_ip_location",
  "arguments": {
    "ip": "8.8.8.8"
  }
}
```

预期输出 (示例):
```json
{
  "ip": "8.8.8.8",
  "pro": "美国",
  "proCode": "0",
  "city": "",
  "cityCode": "0",
  "region": "",
  "regionCode": "0",
  "addr": "美国 加利福尼亚州山景市谷歌公司DNS服务器",
  "regionNames": "",
  "err": ""
}
```

## 技术实现

- 基于 Model Context Protocol (MCP) SDK 构建。
- 使用阿里云 IP 地址查询 API 获取 IP 地理位置数据。
- 通过 stdio 传输实现与 AI 模型的通信。
- 自动处理 API 响应，提供格式化的 JSON 输出。

## 注意事项

- 请确保已正确配置 `ALIYUN_IP_API_KEY` 环境变量。
- API 调用可能受到阿里云的频率限制，请查阅相关文档了解详情。

## 许可证

本项目采用 MIT 许可证。详情请参阅 `LICENSE` 文件（如果项目包含）。
npm package: @mcpcn/mcp-mindmap
Description: MCP server for converting Markdown to interactive mindmaps
Latest version: 1.0.4

# 思维导图 MCP 服务器 (TypeScript版)

一个用于将Markdown内容转换为交互式思维导图的MCP服务器，使用TypeScript实现。

## ✨ 特性

- ✅ **纯TypeScript实现** - 无需Python环境
- ✅ **直接使用markmap API** - 性能更好，无subprocess开销
- ✅ **灵活的返回模式** - 支持返回HTML内容或文件路径
- ✅ **可定制化** - 支持显示/隐藏工具栏，自定义输出路径
- ✅ **简单部署** - 只需Node.js环境

## 📦 安装

### 方式1：本地开发

```bash
cd typescript/思维导图生成
npm install
npm run build
```

### 方式2：全局安装（待发布）

```bash
npm install -g @mcpcn/mcp-mindmap
```

## 🚀 使用方法

### 在Claude Desktop中配置

#### 返回HTML内容（可在Artifact中预览）

```json
{
  "mcpServers": {
    "mindmap": {
      "command": "node",
      "args": [
        "/Users/你的用户名/path/to/typescript/思维导图生成/dist/index.js",
        "--return-type",
        "html"
      ]
    }
  }
}
```

#### 返回文件路径（节省token）

```json
{
  "mcpServers": {
    "mindmap": {
      "command": "node",
      "args": [
        "/Users/你的用户名/path/to/typescript/思维导图生成/dist/index.js",
        "--return-type",
        "filePath"
      ]
    }
  }
}
```

## 🛠️ 工具说明

### convert_markdown_to_mindmap

将Markdown内容转换为交互式思维导图HTML。

**参数：**

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `markdown_content` | string | 否* | 要转换的Markdown内容 |
| `input_file_path` | string | 否* | 现有Markdown文件的路径 |
| `output_dir` | string | 否 | 保存HTML文件的目录 |
| `output_filename` | string | 否 | 输出HTML的文件名 |
| `toolbar` | boolean | 否 | 是否显示工具栏（默认：true） |
| `save_to_path` | string | 否 | 强制保存到指定路径 |

**注意：** `markdown_content` 和 `input_file_path` 至少需要提供一个。

## 💡 使用示例

### 示例1：创建项目规划思维导图

在Claude中输入：

```
请帮我创建一个关于"项目规划"的思维导图：

# 项目规划
## 研究阶段
### 市场分析
### 竞品调研
## 设计阶段
### 线框图
### 视觉稿
## 开发阶段
### 前端开发
### 后端开发
## 测试阶段
### 单元测试
### 用户测试
```

### 示例2：从文件生成思维导图

```
请将 ~/Documents/notes.md 文件转换为思维导图，并保存到 ~/Downloads/ 目录
```

### 示例3：生成无工具栏的思维导图

```
生成一个关于"学习路线"的思维导图，不要显示工具栏
```

## 📊 对比Python版本

| 特性 | TypeScript版本 | Python版本 |
|------|---------------|-----------|
| **依赖环境** | 仅需Node.js | 需要Python + Node.js |
| **性能** | 直接调用API | 通过subprocess调用 |
| **部署复杂度** | 低 | 中等 |
| **错误处理** | 更直接 | 需要处理进程间通信 |
| **代码维护** | 更简洁 | 更复杂 |
| **启动速度** | 快 | 较慢 |

## 🧪 本地测试

```bash
# 运行测试脚本
node test-local.js

# 在浏览器中打开生成的HTML
open test-output.html  # macOS
# 或
xdg-open test-output.html  # Linux
# 或
start test-output.html  # Windows
```

## 🔧 开发

```bash
# 安装依赖
npm install

# 构建
npm run build

# 运行
npm start

# 开发模式（构建并运行）
npm run dev
```

## 📝 项目结构

```
typescript/思维导图生成/
├── src/
│   └── index.ts          # 主服务器代码
├── dist/                 # 编译输出
├── package.json          # 项目配置
├── tsconfig.json         # TypeScript配置
├── test-local.js         # 本地测试脚本
├── mcp-config.example.json  # MCP配置示例
└── README.md             # 文档
```

## 🐛 故障排除

### 问题1：找不到node命令

确保Node.js已安装并在PATH中：

```bash
node --version
npm --version
```

### 问题2：构建失败

清理并重新安装依赖：

```bash
rm -rf node_modules package-lock.json
npm install
npm run build
```

### 问题3：MCP服务器无法连接

1. 检查配置文件中的路径是否正确
2. 确保已运行 `npm run build`
3. 重启Claude Desktop

## 📄 License

MIT

## 🙏 致谢

- [markmap](https://markmap.js.org/) - 强大的思维导图库
- [Model Context Protocol](https://modelcontextprotocol.io/) - MCP协议

---

如果这个项目对你有帮助，请给个 ⭐️ Star！