{
  "markdown": "# MCP User Data Enrichment Server\n\nA Model Context Protocol (MCP) server that enriches user data by adding social network links. This server can be integrated with AI platforms like [Smithery.ai](https://smithery.ai/) to provide social media link discovery capabilities.\n\n## Features\n\n- **User Data Enrichment**: Takes user information (name, birth date) and returns social media links\n- **Mock Data Support**: Includes pre-configured social links for demonstration\n- **Dynamic Generation**: Automatically generates social links for new users\n- **MCP Protocol**: Standard MCP implementation via stdio\n- **HTTP Wrapper**: Optional HTTP API for remote access\n- **Smithery Integration**: Ready for integration with Smithery.ai\n\n## Installation\n\n```bash\nnpm install mcp-user-data-enrichment\n```\n\n## Usage\n\n### As MCP Server (Recommended for Smithery)\n\n```bash\n# Direct stdio usage\nnode src/mcp-server.js\n\n# Or via npm script\nnpm run mcp\n```\n\n### As HTTP Server\n\n```bash\n# Start HTTP server on port 3000\nnpm start\n```\n\n## API Endpoints\n\n### HTTP API (when running as server)\n\n- `GET /status` - Server status\n- `GET /tools` - List available tools\n- `POST /tools/call` - Call any tool\n- `POST /enrich-user` - Enrich user data\n\n### MCP Protocol\n\nThe server provides one tool: `enrich_user_data`\n\n**Input Schema:**\n```json\n{\n  \"firstName\": \"string\",\n  \"lastName\": \"string\", \n  \"birthDate\": \"string (YYYY-MM-DD)\"\n}\n```\n\n**Output:**\n```json\n{\n  \"user\": {\n    \"firstName\": \"John\",\n    \"lastName\": \"Smith\",\n    \"birthDate\": \"1990-01-01\"\n  },\n  \"socialLinks\": {\n    \"instagram\": \"https://instagram.com/john_smith\",\n    \"facebook\": \"https://facebook.com/john.smith\",\n    \"twitter\": \"https://twitter.com/john_smith\",\n    \"linkedin\": \"https://linkedin.com/in/john_smith\"\n  }\n}\n```\n\n## Smithery.ai Integration\n\nThis MCP server is designed to work with [Smithery.ai](https://smithery.ai/), a platform for AI agent orchestration.\n\n### Setup in Smithery\n\n1. **Deploy your server** to a public repository on GitHub\n2. **Configure MCP connection** in Smithery:\n   ```json\n   {\n     \"mcpServers\": {\n       \"user-data-enrichment\": {\n         \"command\": \"node\",\n         \"args\": [\"path/to/mcp-server.js\"]\n       }\n     }\n   }\n   ```\n3. **Use the tool** in your AI agent workflows\n\n### Example Smithery Usage\n\n```javascript\n// In your Smithery agent\nconst result = await mcp.callTool('enrich_user_data', {\n  firstName: 'John',\n  lastName: 'Smith', \n  birthDate: '1990-01-01'\n});\n\nconsole.log(result.content[0].text);\n```\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev\n\n# Test MCP server directly\necho '{\"jsonrpc\": \"2.0\", \"id\": 1, \"method\": \"tools/list\"}' | node src/mcp-server.js\n```\n\n## Testing\n\n```bash\n# Run test client\nnode test-client.js\n\n# Test with curl\ncurl -X POST http://localhost:3000/enrich-user \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"firstName\": \"John\", \"lastName\": \"Smith\", \"birthDate\": \"1990-01-01\"}'\n```\n\n## Mock Data\n\nThe server includes mock social links for these users:\n- John Smith\n- Sarah Johnson  \n- Michael Brown\n\nFor other users, links are generated automatically based on the name.\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests if applicable\n5. Submit a pull request\n\n## License\n\nMIT License - see LICENSE file for details\n\n## Deployment Files\n\n- `Dockerfile` - Docker configuration for containerized deployment\n- `smithery.yaml` - Smithery.ai configuration file\n- `.dockerignore` - Docker ignore file for optimized builds\n\n## Related Links\n\n- [Model Context Protocol](https://modelcontextprotocol.io/)\n- [Smithery.ai](https://smithery.ai/) - AI Agent Orchestration Platform\n- [MCP Inspector](https://github.com/modelcontextprotocol/inspector) - MCP Testing Tool\n\n",
  "bytes": 3782,
  "sha": "b7d57278f961b33aaba158178131684480f3524395491e759ab32f1c362b509b",
  "repo_slug": "jekakos/mcp-user-data-enrichment",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_smithery_jekakos_mcp_user_data_enrich_9408c327/readme"
}