Serve7 MCP Connector Library

Amazon Connect AI Agents と Bedrock AgentCore 向けの再利用可能な MCP ツールです。7つの汎用コネクタ —顧客検索、サポートチケットの作成、チケット状況の確認、予約の設定、CRM レコードの更新、ナレッジの取得、タスクの作成— をここで一度構築し、プロジェクトごとにゼロから組み立てるのではなく、すべての Serve7 カスタマーエンゲージメントで再利用します。

これは 2026年秋の co-op アイデアリスト（「Serve7 MCP Connector Library」）のプロジェクト #6です。動作する初版です。現在、すべてのコネクタがインメモリのモックバックエンドに対してエンドツーエンドで動作します（AWSアカウントも実CRMも不要で、試すための認証情報もいりません）。後で実バックエンドに差し替えられるよう、きれいな接続境界も用意しています。

アダプター経由にする理由（直接接続しない理由）

各コネクタのビジネスロジック（スキーマ検証、何をエラーとみなすか、入出力されるフィールド）は src/connectors/*.ts にあり、具体的なバックエンド SDK と直接通信することはありません。その代わりに src/adapters/types.ts にある5つの小さなインターフェース — CrmAdapter・TicketingAdapter・SchedulingAdapter・KnowledgeAdapter・TaskAdapter — のいずれかを呼び出します。現時点ではこれらはすべてインメモリで実装されています(src/adapters/mock.ts)。将来、実際の Salesforce/ServiceNow/Connect-Cases/Bedrock-Knowledge-Base バックエンドを接続するときには、新しいアダプタークラスを1つ作成してスイッチ文 (src/adapters/index.ts) を1つ切り替えるだけで済みます。コネクタコード、そのテスト、エージェントが見る MCP ツール定義は一切変更する必要はありません。docs/adding-a-real-adapter.md を参照してください。

MCP client (Claude Desktop, Bedrock AgentCore, ...)
        │  tool call: customer_lookup({ customerId: "cust-1001" })
        ▼
src/server.ts (stdio) or src/http-server.ts (deployed)
        │  registers every connector as an MCP tool
        ▼
src/connectors/customer-lookup.ts
        │  validates input (zod), calls adapters.crm.lookupCustomer(...)
        ▼
src/adapters/index.ts  →  mock.ts today, a real adapter later

Related MCP server: Runtime MCP Server

プロジェクト構成

src/
  connectors/       one file per MCP tool — schema + business logic only
  adapters/          the CRM/ticketing/scheduling/knowledge/task interfaces,
                      plus the in-memory mock implementations
  mock-data/         seed data the mock adapters serve
  mcp-server-factory.ts   registers every connector on an McpServer instance
  server.ts          stdio entrypoint (local dev, Claude Desktop, Claude Code)
  http-server.ts      Streamable-HTTP entrypoint (deployed, e.g. behind Lambda)
tests/               one test file per connector + a registry sanity test
deploy/              Dockerfile + AWS SAM template for a Lambda deployment
docs/                per-connector reference + how to add a real adapter

ローカルでの実行

npm install
npm test              # 29 tests, all against the mock adapters
npm run typecheck      # strict TypeScript, zero `any` in connector code
npm start              # stdio MCP server — Ctrl+C to stop
npm run start:http      # HTTP MCP server on :8080 (curl http://localhost:8080/health)
npm run smoke           # real MCP client over stdio, calls all 7 tools end to end
npm run smoke:http      # same, over HTTP — start:http must be running first

Claude Desktop / Claude Code への組み込み

MCP クライアントが stdio サーバーを向くようにします。たとえば Claude Desktop の claude_desktop_config.json で次のように設定します:

{
  "mcpServers": {
    "serve7-connectors": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/serve7-mcp-connectors/src/server.ts"]
    }
  }
}

その後、「顧客 cust-1001 を検索」や「緊急休業の案内について調べるナレッジ記事はありますか？」のように質問してください。customer_lookup / retrieve_knowledge がモックデータに対して呼び出されます。

本番利用のためのデプロイ（例: Bedrock AgentCore から）

deploy/README.md を参照してください。sam deploy を使用して、IAM 認証付きの Function URL の背後にコンテナイメージ Lambda を構築します。

8つ目のコネクタを追加する

1. defineConnector() を使用して src/connectors/my-new-tool.ts を作成します。既存のコネクタ（例: create-task.ts）と同じ形状に倣います。

2. それを src/connectors/index.ts の CONNECTORS 配列に追加します。

3. tests/ 内にテストファイルを追加します。

4. docs/connectors.md にドキュメントを追加します。

server.ts と http-server.ts、およびレジストリテストはすべて自動的に認識します。他に触るものはありません。

この初版で意図的にスコープ外にしているもの

元のプロジェクト概要によると、各コネクタは最終的に、認証方式（アダプターレイヤーで完了）、デプロイテンプレート（deploy/ で完了）、ドキュメント（未完了ではありません、docs/ にあります）も含むべきですが、それらはすべて同梱されています。まだ構築されておらず、フォローアップの価値があるのは、少なくとも1つのバックエンド向けの実アダプター（これによりオールモックが終わります）と、デプロイされた HTTP エンドポイントから呼び出すライブな Bedrock AgentCore エージェントのエンドツーエンドでの配線です。