AdLens

MCP办公协作

提供方 未标注

办公协作 HTTP · 远程 未标注 社区 / 第三方 Claude DesktopClaudeCursorVS Code
查看接入方式

您的AdMob数据,无需打开AdMob控制台。一个快速的MCP服务器,让您的AI助手能够查询相同的实时数据。

一句话选型结论

按资料字段整理

AdLens 属于办公协作类 MCP 服务器,HTTP · 远程,鉴权方式未标注,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式HTTP · 远程 鉴权未标注 部署方式远程部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

生产力

安装与配置

HTTP · 远程 未标注
连远程 HTTPS 端点,通常为 Streamable HTTP
npx add-mcp 'https://adlens.moreproductive.in/mcp'

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
AdLens当前 未标注 HTTP · 远程 远程部署 有 未标注
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方未标注上游标注的维护方 未标注
分类办公协作本站按上游分类展示
连接方式HTTP · 远程连远程 HTTPS 端点,通常为 Streamable HTTP
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型远程部署上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

9.7 KB
来自项目仓库与上游目录的原文,未做删改

AdLens

Your AdMob numbers, without the AdMob console.

A fast AdMob analytics dashboard, plus an MCP server so your AI assistant can query the same live data.

Live app ·
MCP setup ·
Self-host ·

Ask a question. Claude calls AdLens. Live AdMob answers.


What is AdLens?

The AdMob console shows you totals. AdLens shows you causes.

Connect your AdMob account once (read-only) and you get:

  1. A fast web dashboard for revenue, impressions, eCPM, mediation and country breakdowns.
  2. An MCP server so Claude, Cursor, Codex and other AI clients can answer questions from the same live data, such as "Which ad format has the best eCPM this month?"

It is free, read-only, and stores none of your report data. You can use the hosted version or run your own.

Features

Dashboard

  • Live, not synced: fetched from the AdMob API when you open a page.
  • Today at a glance: today, yesterday, last 7 days and this month, with impressions and eCPM.
  • Period comparisons: every KPI shows its change vs. the previous period.
  • Sortable breakdowns: by day, app, ad unit, format, mediation source or country.
  • Per-app deep dives with the same depth, plus dark and light themes.

The AdLens dashboard (sample data).

MCP server

Five read-only tools that any MCP client can call:

Tool What it does
account_overview Lists your connections and apps (id, name, platform, package name)
revenue_summary Totals plus daily or weekly series, using presets or explicit dates
breakdown Revenue by app, ad unit, format, country, ad source (mediation) or date
top_movers Period-over-period movers, with the previous period chosen automatically for presets
list_ad_units Your ad unit inventory

Example prompts to try:

  • "Revenue summary for the last 30 days"
  • "Top movers by country, this week vs last week"
  • "Break down mediation revenue for my top app"
  • "Which ad format has the best eCPM this month?"

Getting started (hosted)

Setup takes about a minute.

  1. Sign in at adlens.moreproductive.in with an email one-time code or Google. A password is optional.
  2. Connect AdMob. You approve one Google OAuth consent screen with the admob.readonly scope.
  3. Use it your way. Open the dashboard, or generate an API key and connect your AI client (below).

Connect your AI assistant (MCP)

Generate an API key on the API Keys page of the dashboard. Keys look like ak_live_... and are shown once, so copy yours right away. Then add AdLens to your client.

The MCP endpoint is:```
https://adlens.moreproductive.in/mcp


If you self-host, replace the domain with your own. AdLens is a standard **Streamable HTTP** MCP server authenticated with a Bearer token, so any client that supports a remote URL with custom headers will work.

Claude Code```bash
claude mcp add --transport http adlens https://adlens.moreproductive.in/mcp \
  --header "Authorization: Bearer ak_live_..."

Or add it to .mcp.json:```json
{
"mcpServers": {
"adlens": {
"type": "http",
"url": "https://adlens.moreproductive.in/mcp",
"headers": { "Authorization": "Bearer ak_live_..." }
}
}
}


Claude Desktop

Claude Desktop's config file has no native URL + header support, so bridge it with `mcp-remote`.

Edit `claude_desktop_config.json`:

- macOS: `~/Library/Application Support/Claude/`
- Windows: `%APPDATA%\Claude\`
- Linux: `~/.config/Claude/````json
{
  "mcpServers": {
    "adlens": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://adlens.moreproductive.in/mcp",
        "--header", "Authorization: Bearer ak_live_..."
      ]
    }
  }
}

On Windows, use npx.cmd instead of npx as the command:```json
{
"mcpServers": {
"adlens": {
"command": "npx.cmd",
"args": [
"-y", "mcp-remote",
"https://adlens.moreproductive.in/mcp",
"--header", "Authorization: Bearer ak_live_..."
]
}
}
}


Codex

In `~/.codex/config.toml` (Windows: `%USERPROFILE%\.codex\config.toml`):```toml
[mcp_servers.adlens]
url = "https://adlens.moreproductive.in/mcp"
http_headers = { "Authorization" = "Bearer ak_live_..." }

Cursor, VS Code, Windsurf and other clients

For Cursor, edit ~/.cursor/mcp.json (Windows: %USERPROFILE%\.cursor\mcp.json):```json
{
"mcpServers": {
"adlens": {
"url": "https://adlens.moreproductive.in/mcp",
"headers": { "Authorization": "Bearer ak_live_..." }
}
}
}


For stdio-only clients, use the `mcp-remote` bridge shown in the Claude Desktop section.

Antigravity

In `~/.gemini/antigravity/mcp_config.json` (Windows: `%USERPROFILE%\.gemini\antigravity\mcp_config.json`), or via the MCP Store panel → Manage MCP Servers → View raw config:```json
{
  "mcpServers": {
    "adlens": {
      "serverUrl": "https://adlens.moreproductive.in/mcp",
      "headers": { "Authorization": "Bearer ak_live_..." }
    }
  }
}

OpenCode

In opencode.json (project) or ~/.config/opencode/opencode.json. This path is the same on Windows (%USERPROFILE%\.config\opencode\opencode.json), not %APPDATA%. Setting oauth: false makes OpenCode use your Bearer key instead of trying OAuth sign-in first.```json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"adlens": {
"type": "remote",
"url": "https://adlens.moreproductive.in/mcp",
"enabled": true,
"oauth": false,
"headers": { "Authorization": "Bearer ak_live_..." },
"timeout": 30000
}
}
}


> **Tip:** to test the endpoint without an AI client, run the MCP Inspector: `npx @modelcontextprotocol/inspector`

## Self-hosting

AdLens is multi-tenant by design and easy to run yourself. You need:

- Node.js (LTS) and pnpm, or just Docker
- A Postgres database (the included Docker Compose file starts one)
- A **MojAuth** project for sign-in (email OTP + Google). You'll need its API key.
- A **Google Cloud OAuth client** with the AdMob API enabled and the `admob.readonly` scope

### 1. Clone and configure```bash
git clone https://github.com/ys-pro-duction/AdLens.git
cd AdLens
cp .env.example .env   # then fill in the values below

Generate the random secrets with:```bash
openssl rand -hex 32


| Variable | Required | Description |
| --- | --- | --- |
| `APP_URL` | yes | Public URL of your instance (use your `https` domain in production) |
| `DATABASE_URL` | yes | Postgres connection string |
| `MOJOAUTH_API_KEY` | yes | Your MojAuth project's key (email OTP + Google sign-in) |
| `SESSION_SECRET` | yes | Random secret used to sign session cookies |
| `GOOGLE_CLIENT_ID` / `GOOGLE_CLIENT_SECRET` | yes | Google OAuth client for connecting AdMob |
| `ENCRYPTION_KEY` | yes | 32-byte hex key used to encrypt refresh tokens at rest |
| `OAUTH_STATE_SECRET` | no | Separate secret for signing OAuth state |
| `TRUST_PROXY` | no | Set to `1` when running behind nginx so rate limits see real client IPs |
| `HOST` | no | Bind address. Use `127.0.0.1` behind a reverse proxy |
| `MOJOAUTH_AUDIENCE` | no | Optional audience check for MojAuth tokens |
| `MOJOAUTH_ISSUERS` | no | Override the allowed MojAuth token issuers |

`.env.example` is kept current and has the full annotated list.

In your **Google Cloud OAuth client**, register `/api/admob/callback` as an authorized redirect URI. In your **MojAuth dashboard**, register the callback URL it shows you.

### 2a. Run with Docker (everything)```bash
docker compose up --build

2b. Run locally for development```bash

pnpm install
docker compose up -d db # Postgres only
pnpm db:migrate
pnpm dev # API on :3000, web on :5173


### 3. Production

Build from the **repo root** (building a single package can leave a stale `packages/db/dist`):```bash
git pull && pnpm install && pnpm db:migrate && pnpm build

In production the API serves the built web app (apps/web/dist), so there is a single process to run. Run it under a process manager of your choice (the hosted instance uses pm2, with Postgres in Docker).

Behind nginx (or any reverse proxy):

  • Set APP_URL to your https domain
  • Set TRUST_PROXY=1
  • Bind the app to localhost with HOST=127.0.0.1

> Note: rate limits are held in memory per process, so AdLens is designed to run as a single process. If it is exposed directly (no proxy), leave TRUST_PROXY unset, because X-Forwarded-For can be spoofed.

Fair-use limits

AdLens is free, with no plans and no billing. Per-IP rate limits protect the service:

Endpoint Limit
Dashboard API (/api) 300 requests / minute
MCP server (/mcp) 15 requests / minute

If you self-host, these limits are yours to adjust in the source.

Architecture```mermaid

flowchart LR
A[Vue dashboard] --> B[Express API]
C[MCP clients] --> B
B --> D[Live AdMob layer<br/>60-min cache · single-flight]
D --> E[(Google AdMob API)]
B --> F[(Postgres<br/>identity · encrypted keys )]


There is no worker, no warehouse and no stored metrics. Reports are fetched from Google on demand and aggregated in JS.

## Tech stack &amp; layout

TypeScript monorepo (pnpm workspaces):```
apps/web        Vue 3 + Vite SPA (ECharts): dashboard, reports, mediation, API keys, settings
apps/api        Express API + stateless MCP server; serves web/dist in production
                (live AdMob serving layer: apps/api/src/live)
packages/db     Drizzle schema + migrations (multi-tenant: tenant_id everywhere)
packages/admob  AdMob OAuth + reporting API client
packages/crypto AES-256-GCM secrets, API key generation/hashing, scrypt
packages/shared Shared TypeScript types and AdMob constants

Disclaimer

AdLens is an independent project and is not affiliated with, endorsed by, or sponsored by Google. AdMob and Google are trademarks of Google LLC.

License

MIT

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
AdLens 怎么安装?

在客户端按下面的安装命令接入:npx add-mcp 'https://adlens.moreproductive.in/mcp'。装完在客户端配置里引用同一个包或端点。

AdLens 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是HTTP · 远程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

AdLens 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

AdLens 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

AdLens 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、VS Code、Windsurf、Gemini CLI;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

AdLens 能提供哪些能力?

资料显示能力标签包括 生产力。具体工具清单以官方文档为准。

AdLens 需要什么运行环境?

属于远程端点,不需要在本地装运行时。

AdLens 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为HTTP · 远程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。