Marvin Date MCP

MarvinDateMcp-日期上下文MCP服务器

模型上下文协议（MCP）服务器，为位置感知AI应用程序提供全面的数据上下文分析。用。NET 9，旨在帮助LLM在会话环境中理解日期。

生产就绪 具有企业级安全控制。

特性

• 位置感知日期分析：接受地名或POI（例如“迪拜”、“伦敦”、“哈利法塔”）
• 全面的日期背景：返回今天、明天、后天、本周、下周、即将到来的假期和关键日期
• 区域周末支持：处理不同的周末时间表（例如，阿联酋：周五至周六，英国：周六至周日）
• 银行假日：与Nager集成。公众假期API日期
• 时区处理：使用NodaTime进行精确的时区转换
• 缓存：Google API调用和假日数据的内存缓存
• HTTP传输：使用MCP HTTP传输进行远程访问

安全特性✅

• API密钥验证：所有MCP端点都需要X-API-Key标头
• 速率限制：每个IP地址每分钟100个请求
• Azure密钥库：使用托管身份安全存储秘密
• CORS限制：可配置的允许来源（无通配符）
• 安全标头：HSTS、CSP、X-Frame-Options、X-XSS-Protection
• 应用洞察：全面的记录和监测
• IP允许列表：可选的基于NSG的网络限制
• 仅限HTTPS：强制执行TLS 1.2+

看 安全.md 详细的安全架构。

设置

先决条件

• .NET 10 SDK
• 启用地理编码API和时区API的Google API密钥

本地开发

1. 设置API密钥:

- 从获取Google API密钥 谷歌云控制台 - 启用地理编码API和时区API - 生成MCP API密钥： openssl rand -base64 32 - 创建 .env.local 在项目根目录中：

     GOOGLE_API_KEY=your_google_api_key_here
     MCP_API_KEY=your_generated_mcp_key_here

1. 构建项目:

   dotnet build

1. 运行服务器:

   dotnet run --project src/MarvinDateMcp.Api/MarvinDateMcp.Api.csproj

服务器将于启动 http://localhost:5000 （或配置的端口）。

Azure部署

看 部署.md 获取全面的部署指南。

快速部署：

# Configure .env.local with API keys
cd terraform
.\deploy.ps1

这将：

• 部署Azure基础架构（密钥库、应用服务、应用洞察）
• 构建和部署应用程序
• 运行验证测试

MCP工具

analyze_date_context

描述：分析位置的综合日期上下文。返回今天、明天、后天、本周、下周、即将到来的假期和关键日期。

认证：需要 X-API-Key 具有有效MCP API密钥的标头。

输入:

• location （字符串，必填）：地名、城市或POI（例如，“迪拜”、“伦敦”、“肯尼迪机场”）
• as_of_date （字符串，可选）：在ISO 8601格式（例如“2026-02-15”）中用作所有计算的“今天”的日期。如果没有提供，则使用该位置时区中的当前日期。

示例请求:

curl -X POST https://YOUR_APP_SERVICE_URL/mcp \
  -H "X-API-Key: your_mcp_api_key" \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: your_session_id" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "analyze_date_context",
      "arguments": {
        "location": "Dubai",
        "as_of_date": "2026-02-15"
      }
    }
  }'

输出：包含全面日期信息的JSON：

{
  "location": {
    "resolvedName": "Dubai",
    "formattedAddress": "Dubai, United Arab Emirates",
    "countryCode": "AE",
    "timezone": "Asia/Dubai",
    "utcOffset": "+04:00",
    "currentLocalTime": "2026-01-27T15:22:00"
  },
  "today": {
    "date": "2026-01-27",
    "dayOfWeek": "Tuesday",
    "isWeekend": false,
    "isHoliday": false,
    "holidayName": null
  },
  "tomorrow": { ... },
  "dayAfterTomorrow": { ... },
  "thisWeek": {
    "weekendDays": ["Friday", "Saturday"],
    "weekendDates": ["2026-01-30", "2026-01-31"],
    "remainingWorkdays": ["2026-01-28", "2026-01-29"]
  },
  "nextWeek": {
    "monday": "2026-02-02",
    "friday": "2026-02-06",
    "weekendDates": ["2026-02-06", "2026-02-07"],
    "workdays": ["2026-02-01", "2026-02-02", "2026-02-03", "2026-02-04", "2026-02-05"]
  },
  "upcomingHolidays": [
    { "date": "2026-02-10", "name": "Isra and Mi'raj", "dayOfWeek": "Tuesday" }
  ],
  "keyDates": {
    "nextMonday": "2026-02-02",
    "nextTuesday": "2026-01-28",
    "nextWednesday": "2026-01-29",
    "nextThursday": "2026-01-30",
    "nextFriday": "2026-01-31",
    "nextSaturday": "2026-02-01",
    "nextSunday": "2026-02-08",
    "nextWeekend": { "start": "2026-01-30", "end": "2026-01-31" }
  }
}

用例

LLM可以使用此工具回答以下问题：

• “我明天可以参观吗？”
• “下周怎么样？”
• “后天？”
• “星期五怎么样？”
• “星期一是假日吗？”
• “下个周末是什么时候？”

周末规则

服务器支持特定位置的周末：

• 阿联酋、沙特阿拉伯、以色列、巴林、科威特、阿曼、卡塔尔：周五至周六
• 所有其他国家：周六至周日

建筑

• 谷歌地理编码服务：将地名解析为坐标、时区和国家代码
• 假期服务：从纳格尔那里度假。带缓存的日期API
• 周末服务：根据国家确定周末天数
• DateContextService：协调所有服务以建立全面的响应
• 日期上下文工具：向LLM公开服务的MCP工具

端点

• /mcp -MCP服务器端点
• /health -健康检查端点
• / -简单的主页

技术

• .NET 9
• 模型上下文协议。AspNetCore 0.6.0-评测1
• NodaTime 3.2.2（时区处理）
• Serilog（日志记录）
• Polly（HTTP弹性）
• Azure密钥库（机密管理）
• Azure应用程序洞察（监控）
• 谷歌地理编码API和时区API
• 纳格。API日期（银行假日）

文档

• 安全.md -安全架构和控制
• 部署.md -部署指南和故障排除
• .env.示例 -环境变量模板

许可证

麻省理工学院