geoapify-mcp-server/LOCAL_MCP_SETUP.md

Geoapify API MCP Server for location-based services - 一键部署的地理位置服务

# 🔧 本地MCP设置指南

由于NPM包尚未发布，这里提供本地安装和使用的方法。

## 🚀 **方法1: 本地全局安装**

### 步骤1: 全局安装本地包
```bash
# 在项目根目录执行
npm install -g .
```

### 步骤2: 验证安装
```bash
# 检查是否安装成功
npm list -g --depth=0 | grep geoapify

# 测试MCP服务器
geoapify-mcp-server --help
```

### 步骤3: MCP客户端配置
```json
{
  "mcpServers": {
    "geoapify-maps": {
      "command": "geoapify-mcp-server",
      "args": [],
      "env": {
        "GEOAPIFY_API_KEY": "3234bd7e35264a8aa29fc15e89f8f76f"
      }
    }
  }
}
```

## 🚀 **方法2: 直接路径调用**

### MCP客户端配置（使用绝对路径）
```json
{
  "mcpServers": {
    "geoapify-maps": {
      "command": "node",
      "args": ["/d/360MoveData/Users/张俊/Desktop/travel/bin/mcp-server.js"],
      "env": {
        "GEOAPIFY_API_KEY": "3234bd7e35264a8aa29fc15e89f8f76f"
      }
    }
  }
}
```

### Windows路径示例
```json
{
  "mcpServers": {
    "geoapify-maps": {
      "command": "node",
      "args": ["D:\\360MoveData\\Users\\张俊\\Desktop\\travel\\bin\\mcp-server.js"],
      "env": {
        "GEOAPIFY_API_KEY": "3234bd7e35264a8aa29fc15e89f8f76f"
      }
    }
  }
}
```

## 🚀 **方法3: NPM Link方式**

### 步骤1: 创建符号链接
```bash
# 在项目根目录执行
npm link
```

### 步骤2: 验证链接
```bash
# 检查链接是否成功
npm list -g --depth=0 | grep travel-mcp

# 测试命令
@travel-mcp/geoapify-server
```

### 步骤3: MCP客户端配置
```json
{
  "mcpServers": {
    "geoapify-maps": {
      "command": "npx",
      "args": ["@travel-mcp/geoapify-server"],
      "env": {
        "GEOAPIFY_API_KEY": "3234bd7e35264a8aa29fc15e89f8f76f"
      }
    }
  }
}
```

## 🚀 **方法4: 创建启动脚本**

### 创建启动脚本
```bash
# 创建启动脚本
cat > start-mcp.sh << 'EOF'
#!/bin/bash
cd "/d/360MoveData/Users/张俊/Desktop/travel"
node bin/mcp-server.js
EOF

chmod +x start-mcp.sh
```

### MCP客户端配置
```json
{
  "mcpServers": {
    "geoapify-maps": {
      "command": "/d/360MoveData/Users/张俊/Desktop/travel/start-mcp.sh",
      "args": [],
      "env": {
        "GEOAPIFY_API_KEY": "3234bd7e35264a8aa29fc15e89f8f76f"
      }
    }
  }
}
```

## 🧪 **测试配置**

### 1. 测试MCP服务器
```bash
# 直接测试
node bin/mcp-server.js

# 发送测试消息
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node bin/mcp-server.js
```

### 2. 运行完整测试
```bash
node scripts/test-mcp.js unit
```

## 📋 **推荐配置**

根据您的系统，推荐使用**方法1（全局安装）**：

```bash
# 1. 全局安装
npm install -g .

# 2. 验证安装
npm list -g --depth=0 | grep travel-mcp

# 3. 使用配置
```

```json
{
  "mcpServers": {
    "geoapify-maps": {
      "command": "@travel-mcp/geoapify-server",
      "args": [],
      "env": {
        "GEOAPIFY_API_KEY": "3234bd7e35264a8aa29fc15e89f8f76f"
      }
    }
  }
}
```

## 🔧 **故障排除**

### 常见问题

#### 1. 命令未找到
```bash
# 检查全局安装
npm list -g --depth=0

# 重新安装
npm uninstall -g @travel-mcp/geoapify-server
npm install -g .
```

#### 2. 权限问题
```bash
# Windows: 以管理员身份运行
# Linux/Mac: 使用sudo
sudo npm install -g .
```

#### 3. 路径问题
```bash
# 使用绝对路径
which node
# 在MCP配置中使用完整的node路径
```

## 📚 **下一步**

1. **选择一种方法**进行本地安装
2. **配置MCP客户端**
3. **重启客户端**
4. **测试功能**

如果需要发布到NPM，请参考发布指南。