Ask Me

ask-me-mcp

ペルソナ MCP サーバーです。公開されている履歴書、プロジェクト一覧、オファーページに基づいて、オペレーターの仕事、パターン、対応可能状況、提供内容について Claude / ChatGPT / Grok に質問できます。

MCP-Server Harness パターンのリファレンス実装です。 このリポジトリは、オペレーターがプロダクト化された6週間のエンゲージメントとして販売しているものと同じアーキテクチャの実例です。この構成が気に入ったら、それが営業トークです。下部のパターンをご覧ください。

機能

AI アシスタントのユーザーが呼び出せる、型付けされた6つのツールです。

ツール	返される内容
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に対応しています。接続方法は3つあります。

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に追加します。場所はOSによって異なります。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評価向けに、どのようなパターンを実装した？ 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フローテストでは、Vercel形式のモックreq/resオブジェクトを使い、インプロセスでregister → authorize → token → protected /api/mcp → 401 challenge → refreshの一連の流れを検証します。

リポジトリ構成

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 サーバー・ハーネス

このプロジェクトは、オペレーターが製品化された6週間のエンゲージメントとしてクライアントに提供するパターン、「MCP-Server Product Playbook」のリファレンス実装です。

構成：

1. 型付きツールコントラクト。 JSON Schema に厳密に準拠した6つのツールです。自由形式の入力はありません。モデルが呼び出せるのはこれらのツールのみで、引数も指定されたものに限られます。
2. コーディネーター＋スペシャリスト（拡張可能）。 v0 では、ツール呼び出しをルーティングする MCP サーバーが単一のコーディネーターを担います。v1 では、より複雑なツールに聞き取り機能とスーパーバイザーエージェントを追加する予定です。
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 をご覧ください。

クレジット

イリェス・トゥンシ が開発 · カリフォルニア州カールスバッド · tounsils.github.io。