使用说明

🎅 圣诞老人MCP

圣诞老人MCP 是一个圣诞主题的MCP（模型上下文协议）服务器，为您的AI助理添加了圣诞老人主题的神奇工具。非常适合为您的GitHub Copilot或其他MCP客户端的对话添加节日风格！

🎁 他在干嘛？

Santa MCP提供三种特殊工具：

1. 🌨️ 拉普尼亚天气

返回神奇的圣诞夜（12月24日至25日）任何地点的天气预报。看看圣诞老人是否有理想的飞行条件！

2. 😇 NaughtyOrNiceReevaluator

评估孩子一年中是好还是坏，并建议合适的礼物类别。包括一个记录了各种儿童行为的数据库。

3. 🦌 雪橇路线优化器

优化不同城市之间的圣诞老人雪地交付路线。计算总距离，估计时间，魔法粉末消耗和所需的驯鹿队伍！

🚀 如何使用

先决条件

.net 10.0或更高级
非客户端MCP（例如GitHub Copilot、Claude Desktop等）

安装

克隆仓库：
```
git clone <url-del-repo>
cd santa-mcp
```
填写项目：
```
dotnet build -c Release
```
发布可执行文件：
```
dotnet publish -c Release -o publish
```
配置您的 MCP 客户端 （见下面的例子）

🐙 GitHub Copilot 配置

要在 VS Code 中使用 Santa MCP 和 GitHub Copilot，请创建或编辑文件 mcp.json 在目录中 ~/Library/Application Support/Code - Insiders/User/ （o） Code/User/ VS代码是稳定的。

macOS/Linux：

{
    "servers": {
        "santa-mcp": {
            "type": "stdio",
            "command": "/usr/local/share/dotnet/dotnet",
            "args": [
                "/percorso/assoluto/santa-mcp/publish/santa-mcp.dll"
            ]
        }
    },
    "inputs": []
}

窗户：

{
    "servers": {
        "santa-mcp": {
            "type": "stdio",
            "command": "C:\\Program Files\\dotnet\\dotnet.exe",
            "args": [
                "C:\\percorso\\assoluto\\santa-mcp\\publish\\santa-mcp.dll"
            ]
        }
    },
    "inputs": []
}

注：

替换 /percorso/assoluto/ 哦 C:\\percorso\\assoluto\\ 您的实际安装路径
命令 dotnet 它必须指向运行时的可执行文件。在您的系统上
确保在 VS Code 设置中为 MCP 启用 GitHub Copilot

其他 MCP 配置

对于其他 MCP 客户端（如 Claude Desktop），请将其添加到 MCP 配置文件（通常是 ~/Library/Application Support/Claude/claude_desktop_config.json su macOS）：

{
  "mcpServers": {
    "santa-mcp": {
      "command": "/percorso/assoluto/santa-mcp/publish/santa-mcp"
    }
  }
}

🎄 对话示例

以下是通过GitHub Copilot与Santa MCP的理想对话：

👤 用户： 你能列出你可用的 santa mcp 工具吗？

🤖 副驾驶： 好吧！我有这些圣MCP工具：

拉普尼亚天气 - 获取当年圣诞夜的某个位置的天气预报
NaughtyOrNiceReevaluator - 评估一个孩子是坏的还是好的，并建议适当的礼物类别
雪橇路线优化器 - 通过计算距离，时间和魔法粉末消耗，优化不同城市之间的圣诞老人雪地运输路线

👤 用户： 你能告诉我LapponiaWeather 米兰的天气吗？

🤖 副驾驶： 米兰2025年圣诞夜（12月24日至25日）的天气：满月和新鲜的雪，温度-10°C，童话般的风景 - 明信片之夜！（2）🌕

👤 用户： 你是罗马人吗？

🤖 副驾驶： 2025年圣诞夜罗马天气（12月24日至25日）：小雪，温度-5°C，风平静 - 非常适合雪地圣诞老人！（2）❄️

👤 用户： 你能评价Bob吗？

🤖 副驾驶： 以下是Bob的评价：

{
  "child": "Bob",
  "locality": "Rovaniemi, Lapponia",
  "year": 2025,
  "score": 65,
  "verdict": "mostly-nice",
  "emoji": "😊",
  "recommendedGiftCategory": "educational-toys",
  "behaviorSummary": "Analizzati 5 comportamenti registrati",
  "message": "👍 Ben fatto Bob! Continua così per l'anno prossimo!",
  "weatherNote": "💡 Suggerimento: usa LapponiaWeather con località 'Rovaniemi, Lapponia' per conoscere il meteo della notte di Natale!"
}

鲍勃主要是好！他经历了一些艰难的时刻（他打破了邻居的花瓶并对父母撒谎），但他通过自发道歉并帮助一位老年人穿过来表现出成熟。

👤 用户： E爱丽丝？

🤖 副驾驶： 我在数据库里找到两个叫Alice的人一位于2015年出生于米兰，一位于1984年出生于罗马。你对哪个爱丽丝感兴趣？

（指定出生年份后）

关于Alice di Milano（2015年出生）：

{
  "child": "Alice",
  "locality": "Milano, Italia",
  "year": 2025,
  "score": 82,
  "verdict": "nice",
  "emoji": "😇",
  "recommendedGiftCategory": "creative-toys",
  "behaviorSummary": "Analizzati 5 comportamenti registrati",
  "message": "🌟 Bravissima Alice! Babbo Natale è molto orgoglioso di te!",
  "weatherNote": "💡 Suggerimento: usa LapponiaWeather con località 'Milano, Italia' per conoscere il meteo della notte di Natale!"
}

爱丽丝很棒！他帮助妈妈，分享玩具，做作业，甚至在没有被问及的情况下清理房间。

👤 用户： 跟我说说查理我也想知道你当地的天气预报。

🤖 副驾驶： 以下是查理的资讯：

行为评估：

{
  "child": "Charlie",
  "locality": "New York, USA",
  "year": 2025,
  "score": 88,
  "verdict": "nice",
  "emoji": "😇",
  "recommendedGiftCategory": "premium-toys",
  "behaviorSummary": "Analizzati 5 comportamenti registrati",
  "message": "🌟 Bravissimo Charlie! Babbo Natale è molto orgoglioso di te!"
}

纽约圣诞夜的天气： 小雪，温度-5°C，风平静 - 非常适合雪地圣诞老人！（2）❄️

查理今年非常出色。他收养了一只狗狗，做了志愿者，为一个悲伤的朋友举办了一个派对，并分享了小吃。真的值得高级礼物！（2）🎁

🛠️ 发展

项目结构

santa-mcp/
├── Program.cs                      # Entry point del server MCP
├── Tools/
│   ├── LapponiaWeatherTool.cs     # Tool per il meteo natalizio
│   ├── NaughtyOrNiceEvaluatorTool.cs  # Tool per valutare i bambini
│   └── SleighRouteOptimizerTool.cs    # Tool per ottimizzare il percorso
├── santa-mcp.csproj               # File di progetto
└── README.md                      # Questo file

添加新工具

要添加新工具：

在文件夹中创建新类 Tools/
添加属性 [McpServerToolType] 到课堂
添加属性 [McpServerTool] 你想展示的方法
美国 [Description("...")] 描述工具及其参数

例如：

using System.ComponentModel;
using ModelContextProtocol.Server;

namespace SantaMcp.Tools;

[McpServerToolType]
public class MioNuovoTool
{
    [McpServerTool]
    [Description("Descrizione del mio tool")]
    public static string MioMetodo(string parametro)
    {
        // La tua logica qui
        return "Risultato";
    }
}

🎅 信用

这个项目是为了演示模型上下文协议的使用而创建的。NET，并在与 AI 的对话中添加一些圣诞魔力！

📝 许可证

本项目以自由许可协议发布。随时使用，修改和分享！

🎄 圣诞快乐，编码快乐！（2）🎁