# Fetch Log MCP Server

一个用于获取远端日志的 MCP (Model Context Protocol) 服务器。

## 功能特性

- 支持从指定 IP 地址获取日志内容
- 可配置端口号和日志路径
- 使用 TypeScript 开发，类型安全
- 简单易用的 API 接口

## 安装和运行

### 方法一：全局安装（推荐）

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

# 查看帮助
fetch-log-mcp-server --help

# 查看版本
fetch-log-mcp-server --version

# 启动服务器
fetch-log-mcp-server
```

### 方法二：本地开发

```bash
# 1. 安装依赖
npm install

# 2. 构建项目
npm run build

# 3. 运行服务器
npm start

# 4. 开发模式
npm run dev
```

## 使用方法

### 命令行选项

- `--help, -h`: 显示帮助信息
- `--version, -v`: 显示版本信息

### MCP 工具参数

- `ip` (必需): 目标服务器的 IP 地址
- `port` (可选): 目标服务器的端口号，默认为 28668
- `path` (可选): 日志路径，默认为 `/logs`

### 示例

#### 1. 启动 MCP 服务器

```bash
fetch-log-mcp-server
```

#### 2. 通过 MCP 客户端调用工具

```json
{
  "name": "fetch_logs",
  "arguments": {
    "ip": "192.168.1.100",
    "port": 28668,
    "path": "/logs"
  }
}
```

这将执行 `curl -XGET "http://192.168.1.100:28668/logs"` 来获取日志内容。

#### 3. 配置文件示例 (mcp.json)

```json
{
  "mcpServers": {
    "fetch-log-server": {
      "command": "fetch-log-mcp-server"
    }
  }
}
```

## 项目结构

```
fetch-log-mcp-server/
├── src/
│   └── index.ts          # 主服务器文件
├── dist/                 # 编译输出目录
├── package.json          # 项目配置
├── tsconfig.json         # TypeScript 配置
└── README.md            # 项目说明
```

## 技术栈

- TypeScript
- @modelcontextprotocol/sdk
- axios (用于 HTTP 请求)

## 错误处理

服务器包含完善的错误处理机制：
- 网络请求超时（30秒）
- 连接错误处理
- 参数验证

## 许可证

MIT