内容
# 🎣 钓鱼游戏 MCP 服务器
基于 tutusagi/ai-fishing-game 的 MCP（Model Context Protocol）服务器实现。
## 项目说明
这是一个文字钓鱼游戏的 MCP 服务器，可以让 Claude 通过 MCP 协议远程玩钓鱼游戏。
## 功能特性
- ✅ 完整的钓鱼游戏引擎
- ✅ MCP 协议支持
- ✅ HTTP 接口（适合 Render 等平台部署）
- ✅ 持久化存档
- ✅ 确定性随机（相同种子产生相同结果）
## 本地测试
```bash
# 安装依赖
pip install -r requirements.txt
# 启动 HTTP 服务器
python app.py
# 测试健康检查
curl http://localhost:10000/health
```
## 部署到 Render
### 步骤 1: 准备 Git 仓库
```bash
# 在项目目录下初始化 Git
git init
git add .
git commit -m "Initial commit"
# 推送到 GitHub（需要先在 GitHub 创建仓库）
git remote add origin https://github.com/你的用户名/fishing-mcp-server.git
git push -u origin main
```
### 步骤 2: 在 Render 上部署
1. 访问 [Render.com](https://render.com)
2. 注册/登录账号
3. 点击 "New +" → "Web Service"
4. 连接你的 GitHub 仓库
5. 配置如下：
- **Name**: `fishing-mcp-server`
- **Runtime**: `Python 3`
- **Build Command**: `pip install -r requirements.txt`
- **Start Command**: `python app.py`
- **Plan**: 选择 Free（免费套餐）
6. 点击 "Create Web Service"
### 步骤 3: 获取服务器地址
部署完成后，Render 会给你一个地址，例如：
```
https://fishing-mcp-server-xxxx.onrender.com
```
## 连接到 Claude Code
在 Claude Code 中添加 MCP 服务器配置：
1. 打开 `~/.claude/settings.json`（或使用 `/config` 命令）
2. 添加 MCP 服务器配置：
```json
{
"mcpServers": {
"fishing-game": {
"url": "https://你的render地址.onrender.com/mcp",
"transport": "http"
}
}
}
```
3. 重启 Claude Code
## 可用工具
### fishing_command
执行游戏指令，支持：
- `help` - 查看帮助
- `status` - 查看状态
- `shop` - 查看商店
- `buy <饵> <数量>` - 购买鱼饵
- `cast [次数]` - 抛竿钓鱼
- `goto [地点]` - 前往地点
- `inventory` - 查看背包
- `sell all` - 卖掉所有鱼
- `encyclopedia` - 查看图鉴
### fishing_new_game
重新开始新游戏，可选指定随机种子
## 游戏说明
- 初始：200 点，5 个普通蚯蚓
- 买饵 → 抛竿 → 钓鱼 → 卖鱼 → 赚点数 → 解锁新地点
- 集齐图鉴，探索不同稀有度的鱼
- 季节会随回合推进而变化
## License
MIT
