Skip to main content
Glama
tounsils

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

A
license - permissive license
Not graded
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    A
    quality
    Not graded
    maintenance
    Exposes an internal engineering knowledge base to AI assistants, allowing users to search and retrieve standards, runbooks, and architecture decisions. It supports RAG-enhanced search, document scraping, and specialized prompts for incident investigation and code reviews.
    5
  • F
    license
    Not graded
    quality
    D
    maintenance
    Exposes internal employee directories and project management systems to AI models through standardized tools and resources. It enables AI assistants to search for team members, query project statuses, and explore organizational hierarchies with secure role-based access control.
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants and developer tools to securely access and interact with an organization's enterprise knowledge, documents, and people through natural language while respecting existing access permissions.
    164
    MIT

View all related MCP servers

Related MCP Connectors

  • Shared, permission-aware company context for AI agents, with provenance, approvals and audit.

  • Connect your team's living knowledge base — docs, data, issues, CRM — to Claude and ChatGPT.

  • Curated knowledge API for AI agents - skill packs, semantic search, validated patterns.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tounsils/ask-me-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server