Wordle MCP Server Sample

Wordle MCP服务器

一个模型上下文协议（MCP）服务器实现，允许您通过GitHub Copilot等AI助手播放Wordle。

🎮 特性

• ✅ 用一个随机的5个字母的单词开始一个新的单词游戏
• ✅ 猜测并接收颜色编码的反馈
• ✅ 查看游戏状态和进度
• ✅ 获取游戏规则和帮助
• ✅ 使用GitHub Copilot通过自然语言进行游戏

📋 需求

• .NET 9.0 SDK或更高版本
• 使用GitHub Copilot的Visual Studio代码
• VS代码中启用了MCP支持

🚀 快速开始

1.克隆和构建

cd wordle-mcp-server-sample
dotnet restore
dotnet build

2.配置VS代码

该项目包括 .vscode/mcp.json 配置。要使用它：

1. 在VS Code中打开此项目
2. 重新加载窗口(Ctrl+Shift+P → “开发人员：重新加载窗口”）
3. 以代理模式打开GitHub Copilot
4. Wordle服务器现在应该可用

3.开始游戏

询问副驾驶：

• “开始一个新的Wordle游戏”
• “猜猜看：CRANE”
• “显示我的游戏状态”
• “我怎么玩Wordle？”

4.使用MCP提示

该项目在 .prompts/ 目录：

.prompts/
├── prompts.json           # Structured MCP prompt definitions
└── wordle-prompts.md      # Comprehensive prompt templates

看 Wordle提示指南 查看完整的有用提示列表，包括：

• 基本游戏提示
• 战略分析提示
• 模式匹配和单词建议
• 学习和辅导提示

🎯 游戏规则

• 在5次或更少的尝试中猜出5个字母的单词
• 每个猜测必须是一个有效的5个字母的单词
• 每次猜测后，您都会收到反馈：

- 🟩 绿色：字母正确，位置正确 - 🟨 黄色：字母在单词中，但位置不对 - ⬜ 格雷：单词中没有字母

🛠️ MCP工具

该服务器为AI助手提供以下工具：

💬 MCP提示

服务器通过MCP prompts API公开10个可发现的提示：

看 如何使用提示 有关访问和使用提示的详细信息。

📁 项目结构

wordle-mcp-server-sample/
├── .github/
│   └── copilot-instructions.md  # Project tracking
├── .prompts/
│   ├── prompts.json             # MCP prompt definitions
│   ├── wordle-prompts.md        # Prompt templates & examples
│   └── HOW_TO_USE_PROMPTS.md    # Guide for using prompts
├── .vscode/
│   ├── mcp.json                 # MCP server configuration
│   └── tasks.json               # Build tasks
├── Models/
│   ├── GameState.cs             # Game state model
│   └── GuessResult.cs           # Guess result model
├── Prompts/
│   └── WordlePrompts.cs         # MCP prompt implementations
├── Services/
│   ├── WordListService.cs       # 400+ valid words
│   └── WordleGameService.cs     # Game logic
├── Tools/
│   └── WordleTools.cs           # MCP tool definitions
├── Program.cs                   # MCP server entry point
├── README.md                    # This file
└── TESTING.md                   # Testing guide

🧪 测试

看 测试.md 详细的测试说明。

手动测试

直接运行服务器：

dotnet run

服务器使用MCP协议通过stdin/stdout进行通信。

构建和运行任务

• 构建: Ctrl+Shift+B （或 Cmd+Shift+B 在Mac上）
• 跑: Ctrl+Shift+P → “任务：运行任务”→ "run"

📝 示例游戏

You: Start a new Wordle game

Copilot: 🎮 New game started!
Guess 1: ⬛ ⬛ ⬛ ⬛ ⬛
Guess 2: ⬛ ⬛ ⬛ ⬛ ⬛
...

You: Guess SLATE

Copilot: S 🟨  L ⬜  A 🟩  T ⬜  E 🟨
Good try! 5 guesses remaining.

You: Guess CRAVE

Copilot: C 🟩  R 🟩  A 🟩  V ⬜  E 🟨

You: Guess CRATE

Copilot: 🎉 Congratulations! You guessed 'CRATE' in 3 tries!

🏗️ 实现细节

• 框架: .NET 9.0控制台应用程序
• MCP-SDK：ModelContextProtocol v0.4.0-review.3
• 托管：微软。扩展。主机v9.0.10
• 运输：标准I/O（标准输入/标准输出）
• 单词列表：400+常见的5个字母单词

📚 了解更多

• 模型上下文协议文档
• C#mcpsdk
• VS代码MCP支持

📄 许可证

MIT许可证

______________________________________________________________________

由以下材料制成❤️ 使用模型上下文协议