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 协议

该服务提供一个工具：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 服务专为与 Smithery.ai 配合使用而设计。Smithery.ai 是一个 AI Agent 编排平台。

在 Smithery 中设置

1. 将服务部署到 GitHub 上的公开仓库
2. 在 Smithery 中配置 MCP 连接：

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

3. 在 AI Agent 工作流中使用该工具

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. Fork 此仓库
2. 创建功能分支
3. 进行修改
4. 适用时添加测试
5. 提交拉取请求

许可证

MIT License - 详情请参阅 LICENSE 文件

部署文件

• Dockerfile - 用于容器化部署的 Docker 配置
• smithery.yaml - Smithery.ai 配置文件
• .dockerignore - 用于优化构建的 Docker 忽略文件

相关链接

• Model Context Protocol
• Smithery.ai - AI Agent 编排平台
• MCP Inspector - MCP 测试工具