jekakos-mcp-user-data-enrichment

MCP ユーザーデータ拡充サーバー

ソーシャルネットワークのリンクを追加してユーザーデータを拡充する Model Context Protocol（MCP）サーバーです。このサーバーは、Smithery.ai のような AI プラットフォームと統合し、ソーシャルメディアリンクの検索機能を提供できます。

機能

• ユーザーデータの拡充：ユーザー情報（名前、生年月日）を受け取り、ソーシャルメディアのリンクを返します
• モックデータのサポート：デモ用に事前設定されたソーシャルリンクが含まれています
• 動的生成：新しいユーザーのソーシャルリンクを自動的に生成します
• MCP プロトコル：stdio を介した標準的な MCP 実装です
• HTTP ラッパー：リモートアクセス用のオプションの HTTP API です
• Smithery との統合：Smithery.ai と統合できる状態で提供されます

インストール

npm install mcp-user-data-enrichment

使用方法

MCP サーバーとして使用（Smithery での使用を推奨）

# Direct stdio usage
node src/mcp-server.js

# Or via npm script
npm run mcp

HTTP サーバーとして使用

# Start HTTP server on port 3000
npm start

API エンドポイント

HTTP API（サーバーとして実行する場合）

• GET /status - サーバーの状態
• GET /tools - 利用可能なツールの一覧
• POST /tools/call - 任意のツールを呼び出す
• POST /enrich-user - ユーザーデータを拡充する

MCP プロトコル

サーバーは 1 つのツールを提供します：enrich_user_data

入力スキーマ：

{
  "firstName": "string",
  "lastName": "string", 
  "birthDate": "string (YYYY-MM-DD)"
}

出力：

{
  "user": {
    "firstName": "John",
    "lastName": "Smith",
    "birthDate": "1990-01-01"
  },
  "socialLinks": {
    "instagram": "https://instagram.com/john_smith",
    "facebook": "https://facebook.com/john.smith",
    "twitter": "https://twitter.com/john_smith",
    "linkedin": "https://linkedin.com/in/john_smith"
  }
}

Smithery.ai との統合

この MCP サーバーは、AI エージェントのオーケストレーションプラットフォームである Smithery.ai と連携するように設計されています。

Smithery でのセットアップ

1. サーバーをデプロイして、GitHub 上のパブリックリポジトリに配置します
2. MCP 接続を設定します：

   {
     "mcpServers": {
       "user-data-enrichment": {
         "command": "node",
         "args": ["path/to/mcp-server.js"]
       }
     }
   }
   

3. ツールを使用して、AI エージェントのワークフローに組み込みます

Smithery の使用例

// In your Smithery agent
const result = await mcp.callTool('enrich_user_data', {
  firstName: 'John',
  lastName: 'Smith', 
  birthDate: '1990-01-01'
});

console.log(result.content[0].text);

開発

# Install dependencies
npm install

# Run in development mode
npm run dev

# Test MCP server directly
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | node src/mcp-server.js

テスト

# Run test client
node test-client.js

# Test with curl
curl -X POST http://localhost:3000/enrich-user \
  -H "Content-Type: application/json" \
  -d '{"firstName": "John", "lastName": "Smith", "birthDate": "1990-01-01"}'

モックデータ

サーバーには、以下のユーザーのモックソーシャルリンクが含まれています：

• John Smith
• Sarah Johnson
• Michael Brown

その他のユーザーについては、名前に基づいてリンクが自動的に生成されます。

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. 該当する場合はテストを追加します
5. プルリクエストを送信します

ライセンス

MIT ライセンス - 詳細は LICENSE ファイルをご覧ください

デプロイ用ファイル

• Dockerfile - コンテナ化デプロイ用の Docker 設定
• smithery.yaml - Smithery.ai の設定ファイル
• .dockerignore - ビルドを最適化するための Docker 除外ファイル

関連リンク

• Model Context Protocol
• Smithery.ai - AI エージェントオーケストレーションプラットフォーム
• MCP Inspector - MCP テストツール