🎯 概述

一个统一的MCP（模型上下文协议）服务器，使谷歌开发者专家（GDE）和Microsoft MVPs都可以通过AI驱动的对话界面报告他们的活动。

别再手动录入无聊了！ 只要和Claude交流，自然地提交你的活动——无论是YouTube视频、博客文章、会议演讲还是指导环节。

支持项目

• ✅ Microsoft MVP - 与MVP门户的直接API集成
• ✅ Google GDE - 与 Advocu API 集成
• 🔧 两者同时 - 如果你既是MVP又是GDE，所有事情都用一个工具！

---

🚀 快速启动

先决条件

• Node.js 18+
• Claude桌面
• 至少一个访问令牌（MVP 或 GDE）

安装

选项1：地方开发（推荐）

选项2：全局安装

配置

编辑你的Claude Desktop配置文件：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%/Claude/claude_desktop_config.json

MVP + GDE均有：

** 📚 重要**：DOCS_DIR 环境变量是文档工具工作所必需的**。

Unified Activity Reporting MCP Server

🎯 Overview

A unified MCP (Model Context Protocol) server that enables both Google Developer Experts (GDEs) and Microsoft MVPs to report their activities through AI-powered conversational interfaces.

Stop the boring manual data entry! Just talk to Claude and submit your activities naturally - whether it’s a YouTube video, blog post, conference talk, or mentoring session.

Supported Programs

• ✅ Microsoft MVP - Direct API integration with the MVP portal
• ✅ Google GDE - Integration with Advocu API
• 🔧 Both at once - If you’re both an MVP and GDE, use one tool for everything!

---

🚀 Quick Start

Prerequisites

• Node.js 18+
• Claude Desktop
• At least one access token (MVP or GDE)

Installation

Option 1: Local Development (Recommended)

git clone https://github.com/carlosazaustre/advocu-mcp-server.git
cd advocu-mcp-server
npm install
npm run build

Option 2: Global Install

npm install -g advocu-mcp-server

Configuration

Edit your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

For Both MVP + GDE:

{
  "mcpServers": {
    "activity-reporting": {
      "command": "node",
      "args": ["/absolute/path/to/advocu-mcp-server/dist/index.js"],
      "env": {
        "MVP_ACCESS_TOKEN": "your_mvp_bearer_token",
        "MVP_USER_PROFILE_ID": "your_mvp_profile_id",
        "ADVOCU_ACCESS_TOKEN": "your_gde_token",
        "DOCS_DIR": "/absolute/path/to/advocu-mcp-server/docs"
      }
    }
  }
}

📚 Important: The DOCS_DIR environment variable is required for documentation tools to work. Set it to the absolute path of the docs directory in your installation.

MVP Only:

{
  "mcpServers": {
    "activity-reporting": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": {
        "MVP_ACCESS_TOKEN": "your_mvp_bearer_token",
        "MVP_USER_PROFILE_ID": "your_mvp_profile_id",
        "DOCS_DIR": "/absolute/path/to/advocu-mcp-server/docs"
      }
    }
  }
}

GDE Only:

{
  "mcpServers": {
    "activity-reporting": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": {
        "ADVOCU_ACCESS_TOKEN": "your_gde_token",
        "DOCS_DIR": "/absolute/path/to/advocu-mcp-server/docs"
      }
    }
  }
}

Get Your Tokens

Microsoft MVP Token

For Claude Desktop users only (not Claude Code):

npm run capture-mvp-token

This tool will:

1. Open your default browser to the MVP portal (you should already be logged in)
2. Show you detailed instructions to capture the token from DevTools
3. Paste your token when prompted
4. Automatically update your Claude Desktop config file with the new token