Skip to main content
Glama
ask-me

ask-me

by tounsils

ask-me-mcp

一个基于人设(persona)的 MCP 服务器。你可以向 Claude / ChatGPT / Grok 询问运营者的工作、模式、可用性和报价——所有回答都以其公开简历、项目索引和报价页面为基础。

MCP-Server Harness 模式的参考实现。 本仓库是同一架构的工作示例,运营者以产品化的 6 周咨询形式向客户销售该架构。如果你喜欢这种形态,这就是销售说辞——请参阅文末的 模式。

它能做什么

任何 AI 助手用户都可以调用六个类型化工具:

工具

返回内容

get_current_focus

当前的时间分配、活跃合作项目,以及正在推进的主要垂直领域切入点。

get_engagement_summary

以适合公开披露的安全级别描述某个具体合作项目(NXT Robotics、AIMIA、Hydrostasis、Digital QR Card)。

search_reusable_patterns

对运营者的 12+ 个可复用工程模式目录进行关键词搜索。

check_availability

有多少个 Playbook / Retainer 名额开放,以及最早的下一个开放日期。

get_offer_details

当前捆绑报价:MCP-Server Playbook + Fractional CTO Retainer。

book_discovery_call

预约 discovery call 的说明 + 准备指南。不会自动安排。明确拒绝议价。

每个响应都附带一个置信度标签和来源引用。服务器从不编造;如果基础数据没有提到,服务器就不会说。

Related MCP server: Internal Data MCP Server

安装(以用户身份)

远程端点使用 MCP Streamable HTTP + OAuth 2.1。有三种连接方式:

1. Claude Desktop — 连接器目录(“Connect”按钮)

通过 Claude Desktop 界面添加:设置(Settings) → 连接器(Connectors) → 添加自定义连接器(Add custom connector) → URL:https://ask-me-mcp-xi.vercel.app/api/mcp。点击 连接(Connect)。桌面客户端会发现 OAuth 元数据,注册为客户端,交换令牌,并挂载这些工具。无需手动配置。

2. Claude Desktop / Claude Code — 配置文件(跳过 OAuth)

添加到 claude_desktop_config.json —— 位置因操作系统而异;请参阅 Claude Desktop 配置文档:

{
  "mcpServers": {
    "ask-me": {
      "url": "https://ask-me-mcp-xi.vercel.app/api/mcp"
    }
  }
}

3. Claude Code CLI

claude mcp add --scope user ask-me https://ask-me-mcp-xi.vercel.app/api/mcp

本地 stdio(开发)

用于本地 stdio 开发(无 HTTP,无 OAuth —— 认证不适用于 stdio):

{
  "mcpServers": {
    "ask-me": {
      "command": "node",
      "args": ["/absolute/path/to/ask-me-mcp/dist/src/server.js"]
    }
  }
}

然后在任意 Claude Code 会话中:

Ilyes 目前的关注点是什么? 他为 LLM 评估交付过哪些模式? 他十月份有 Playbook 合作的档期吗?

开发(以维护者身份)

要求

  • Node.js 20+

  • npm(或 pnpm / yarn —— package.json 以 npm 优先)

设置

git clone https://github.com/tounsils/ask-me-mcp.git
cd ask-me-mcp
npm install

以 stdio 服务器方式本地运行

npm run dev

将 Claude Code 或 MCP Inspector 指向生成的进程。

构建生产版本

npm run build

输出到 dist/。

部署到 Vercel

# Set the JWT signing secret (one-time; required for OAuth).
vercel env add MCP_JWT_SECRET production
# Paste a long random string. Generate one: `openssl rand -base64 48`.

vercel deploy --prod

api/mcp.ts 处理器提供带 OAuth 2.1 保护的 Streamable HTTP 传输 —— 这是 Claude 的连接器目录和 ChatGPT 的 Apps SDK 都使用的格式。完整架构请参阅 docs/oauth-flow.md。

运行评估语料库

npm run eval           # 15 tool cases against handlers directly (no HTTP)
npm run eval:oauth     # 6-step end-to-end OAuth flow (needs MCP_JWT_SECRET)

如果预期答案的匹配比例低于阈值百分比,工具语料库会使构建失败。不通过,不发布。

OAuth 流程测试覆盖注册 → 授权 → 令牌 → 受保护的 /api/mcp → 401 质询 → 刷新 —— 全部在进程内针对 Vercel 形态的模拟 req/res 对象运行。

仓库结构

ask-me-mcp/
├── src/
│   ├── server.ts               # shared MCP server (used by both stdio + HTTP)
│   ├── tools/                  # six typed tool implementations
│   │   ├── getCurrentFocus.ts
│   │   ├── getEngagementSummary.ts
│   │   ├── searchReusablePatterns.ts
│   │   ├── checkAvailability.ts
│   │   ├── getOfferDetails.ts
│   │   └── bookDiscoveryCall.ts
│   ├── grounding/
│   │   ├── data.json           # pre-extracted structured facts (v0)
│   │   └── index.ts            # loaders + search helpers
│   └── rails/
│       └── confidence.ts       # confidence + source-citation wrapper; refusal helper
│   └── oauth/                  # OAuth 2.1 + PKCE + anonymous DCR
│       ├── config.ts           # issuer, scopes, TTLs, endpoint paths
│       ├── jwt.ts              # HS256 sign/verify (via `jose`)
│       ├── clientRegistry.ts   # client_id = signed JWT (no DB)
│       └── codeGrant.ts        # auth code + access/refresh token + PKCE S256
├── api/
│   ├── mcp.ts                          # Vercel serverless entry (Streamable HTTP + Bearer auth)
│   ├── health.ts                       # diagnostic (unauthenticated)
│   ├── register.ts                     # RFC 7591 DCR
│   ├── authorize.ts                    # authorization endpoint (auto-approves)
│   ├── token.ts                        # token exchange with PKCE
│   ├── oauth-protected-resource.ts     # RFC 9728 metadata
│   └── oauth-authorization-server.ts   # RFC 8414 metadata
├── eval/
│   ├── corpus.json             # 15 tool cases + expected answers
│   ├── runner.ts               # replays tool corpus, threshold-gated
│   └── oauth-flow.ts           # 6-step OAuth end-to-end test
├── docs/
│   └── oauth-flow.md           # OAuth architecture + how to swap for real user identity
├── package.json
├── tsconfig.json
├── vercel.json
└── README.md

模式:MCP-Server Harness

本项目是运营者以产品化 6 周咨询形式向客户交付的模式的参考实现 —— MCP-Server Product Playbook。

其形态如下:

  1. 类型化工具契约。 六个严格遵循 JSON Schema 的工具。没有任何自由格式。模型只能调用这些工具,并且只能使用这些参数。

  2. 协调器 + 专家(可扩展)。 v0 有一个协调器(MCP 服务器负责路由工具调用)。v1 将在更复杂的工具中加入信息收集(elicitation)代理与监督(supervisor)代理。

  3. 类型化信号向量。 从基础数据中提取的结构化事实。不是自由文本。

  4. 版本化推理规范。 工具实现本身就是推理规范 —— 在代码中版本化,而不是在提示词中。

  5. 护栏 + 置信度。 每个响应都携带 confidence + sources + 可选的 disclaimers。模型可以展示这些信息。

  6. 外部基础数据。 服务器查询 src/grounding/data.json;模型从不编造。

  7. 评估语料库 + 评估运行器 + 认证。 eval/corpus.json 包含预期答案;npm run eval 会重放这些答案。能发布就发布,不能就不发布。

如果你正在构建符合这一形态的产品(职业指导、医疗分诊、法律接案、财务规划、教练辅导、各类专家系统),运营者提供 6 周固定范围的咨询项目来交付它。请参阅 get_offer_details 或发送邮件至 tounsils@gmail.com。

许可证

MIT。参见 LICENSE。

署名

由 Ilyes Tounsi 构建 · Carlsbad, CA · tounsils.github.io。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers