Ask Me

ask-me-mcp

一个角色 MCP 服务。向 Claude / ChatGPT / Grok 询问运营者的工作、模式、空档情况和服务方案，答案以其公开简历、项目索引和服务方案页面为依据。

MCP-Server Harness 模式的参考实现。 此仓库是该架构的一个可运行示例；运营者将这一架构作为产品化的 6 周合作项目出售。如果你喜欢这种形式，这就是销售介绍——请参阅文末的该模式（MCP-Server Harness）。

功能

任何 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	预约探索通话的说明和准备指南。不会自动安排时间，并会明确拒绝议价。

每个回答都附带置信度标签和来源引用。服务绝不编造信息；如果依据数据中没有提及，服务就不会作答。

安装（作为用户）

远程端点使用 MCP Streamable HTTP + OAuth 2.1。可以通过三种方式连接：

1. Claude Desktop — 连接器目录（“Connect” 按钮）

通过 Claude Desktop UI 添加：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 目前的重点是什么？ 他为大模型评估交付过哪些模式？ 他 10 月有空承接 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 服务 Harness

本项目是这一模式的参考实现。操作者会将其作为产品化的 6 周项目交付给客户——MCP 服务产品手册。

模式构成：

1. 类型化工具契约。 六个严格遵循 JSON Schema 的工具。没有自由格式输入。模型只能调用这些工具，且只能使用这些参数。
2. 协调器 + 专家（可扩展）。 v0 只有一个协调器（负责路由工具调用的 MCP 服务）。v1 将在更复杂的工具中加入引导提问 + 监督 Agent。
3. 类型化信号向量。 从基础数据中提取的结构化事实，而非自由文本。
4. 版本化推理规范。 工具实现本身就是推理规范——在代码中进行版本管理，而不是放在提示词中。
5. 护栏 + 置信度。 每个响应都包含 confidence + sources + 可选的 disclaimers。模型可以展示这些内容。
6. 外部依据。 服务会查询 src/grounding/data.json；模型绝不凭空编造。
7. 评估语料库 + 评估运行器 + 认证。 eval/corpus.json 包含预期答案；npm run eval 会重放这些答案。能否交付，一目了然。

如果你正在构建符合这种模式的产品（职业指导、医疗分诊、法律咨询受理、财务规划、教练服务或任何专家系统），操作者会以固定范围的 6 周项目形式承接并交付。请参阅 get_offer_details 或发送邮件至 [email protected]。

许可证

MIT。请参阅 LICENSE。

致谢

由 Ilyes Tounsi 构建 · 美国加利福尼亚州卡尔斯巴德 · tounsils.github.io。