Beacon MCP

信标MCP

beacon-mcp 是一个个人本地TypeScript模型上下文协议服务器，它将一小部分个人和操作数据源转换为MCP工具。

它揭示了：

• 天气查询
• 交通通勤估算
• Gmail收件箱查询
• 谷歌日历事件查询
• FineApp管理员审核日志查找
• 综合上述内容的综合晨间简报

服务器运行超时 stdio，因此它可以直接连接到MCP兼容客户端，如Codex、Claude Desktop或自定义MCP主机。

它的作用

Beacon旨在回答实际的日常启动和操作问题，例如：

• “今天下午斯泰伦博斯的天气怎么样？”
• “明天早上8点开车要多久？”
• “显示我未读的重要电子邮件。”
• “我今天有什么会议？”
• “今天早上FineApp管理员审核日志中发生了什么？”
• “给我一个完整的上午简报。”

工具

Beacon注册了这些MCP工具：

资源

Beacon还公开了MCP资源：

• beacon://server/info
• beacon://tools/{name}

这些为支持资源的MCP客户端提供了轻量级的服务器和工具元数据。

需求

• Node.js 20+
• npm
• 要使用的集成的API凭据

安装

npm install
cp .env.example .env

填写 .env 使用您需要的凭据和默认值。

环境变量

跑

发展：

npm run dev

构建：

npm run build

启动已编译的服务器：

npm run start

MCP客户端配置

示例MCP服务器条目指向开发中的TypeScript源代码：

{
  "mcpServers": {
    "beacon": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/beacon-mcp/src/index.ts"],
      "env": {
        "WEATHER_API_KEY": "your-key",
        "GOOGLE_MAPS_API_KEY": "your-key",
        "GMAIL_CLIENT_ID": "your-client-id",
        "GMAIL_CLIENT_SECRET": "your-client-secret",
        "GMAIL_REFRESH_TOKEN": "your-refresh-token",
        "FINEAPP_ADMIN_TOKEN": "your-token",
        "TIMEZONE": "Africa/Johannesburg"
      }
    }
  }
}

使用编译版本的示例：

{
  "mcpServers": {
    "beacon": {
      "command": "node",
      "args": ["/absolute/path/to/beacon-mcp/dist/index.js"]
    }
  }
}

输入注释

• 预计天气日期 YYYY-MM-DD.
• 通勤 departureAt 接受：

- 带时区的完整ISO时间戳 - YYYY-MM-DD HH:mm - 像这样的短语 today at 8am 或 tomorrow at 8am

• Gmail搜索使用标准的Gmail查询语法以及可选的标签和未读过滤。
• 日历查找接受单个 date 或a dateFrom / dateTo 范围。

发展

可用脚本：

npm run dev
npm run build
npm run test
npm run test:coverage
npm run format
npm run format:check

项目结构

src/
  index.ts          stdio entrypoint
  server.ts         MCP server construction
  tools/            MCP tool registration
  resources/        MCP resources and templates
  providers/        external API integrations
  schemas/          zod input/output schemas
  utils/            env and time helpers
tests/              server, provider, and tool tests

备注

• 服务器仅对配置了所需凭据的工具成功。
• Gmail和谷歌日历都使用相同的谷歌OAuth刷新令牌流。
• 晨间简报并行运行多个提供者，并返回汇总的组合有效载荷。