Tinder API MCP 服务器

这是一个用于Tinder API的模型上下文协议（MCP）服务器，用TypeScript实现。

概述

此MCP服务器提供了一个与Tinder API交互的标准接口。它处理身份验证、请求处理、速率限制、缓存和错误处理，使得构建集成Tinder的应用程序变得更加容易。

特性

• 身份验证管理：支持短信和Facebook身份验证方法
• 请求处理：验证、转换并转发API请求
• 响应处理：解析、验证并转换API响应
• 速率限制：防止超出API速率限制
• 缓存：高效地缓存API响应
• 错误处理：标准化错误响应
• 安全性：安全存储令牌和HTTPS通信

架构

服务器遵循模块化架构，包括以下组件：

• API网关：MCP工具和资源的入口点
• 身份验证服务：处理用户身份验证流程
• 请求处理器：处理并转发API请求
• 速率限制器：管理API速率限制
• 缓存管理器：缓存API响应
• 错误处理器：标准化错误响应

安装

1. 克隆仓库：

   git clone https://github.com/yourusername/tinder-api-mcp-server.git
   cd tinder-api-mcp-server
   

2. 安装依赖：

   npm install
   

3. 根据.env.example创建一个.env文件：

   cp .env.example .env
   

4. 使用您的配置设置编辑.env文件。

开发

1. 启动开发服务器：

   npm run dev
   

2. 构建项目：

   npm run build
   

3. 运行生产服务器：

   npm start
   

4. 运行测试：

   npm test
   

API 端点

身份验证

• POST /mcp/auth/sms/send: 发送短信验证码
• POST /mcp/auth/sms/validate: 验证短信验证码
• POST /mcp/auth/facebook: 使用Facebook进行身份验证
• POST /mcp/auth/captcha: 验证CAPTCHA
• POST /mcp/auth/refresh: 刷新身份验证令牌

用户

• GET /mcp/user/:userId: 获取用户资料
• GET /mcp/user/recommendations: 获取用户推荐
• PUT /mcp/user/profile: 更新用户资料
• GET /mcp/user/matches: 获取用户匹配

互动

• POST /mcp/interaction/like/:targetUserId: 喜欢一个用户
• POST /mcp/interaction/superlike/:targetUserId: 超级喜欢一个用户
• POST /mcp/interaction/pass/:targetUserId: 跳过一个用户
• POST /mcp/interaction/boost: 提升个人资料可见度
• POST /mcp/interaction/message/:matchId: 发送消息
• GET /mcp/interaction/messages/:matchId: 获取匹配的消息

MCP 工具和资源

• POST /mcp/tools: 执行MCP工具
• GET /mcp/resources/:resourceId: 访问MCP资源
• GET /mcp/info: 获取服务器信息

MCP 工具

服务器提供了以下MCP工具：

• authenticate_sms: 使用短信进行用户身份验证
• authenticate_facebook: 使用Facebook进行用户身份验证
• verify_captcha: 验证CAPTCHA响应
• like_user: 喜欢一个用户资料
• super_like_user: 超级喜欢一个用户资料
• pass_user: 跳过一个用户资料
• boost_profile: 提升用户资料可见度
• get_user_profile: 获取用户资料信息
• get_recommendations: 获取潜在匹配
• clear_cache: 清除缓存
• get_rate_limits: 获取速率限制信息

MCP 资源

服务器提供了以下MCP资源：

• api-docs: API文档
• server-status: 服务器状态信息

安全注意事项

• 不要硬编码密钥或API密钥
• 使用环境变量存储敏感信息
• 对所有端点实施适当的认证
• 使用HTTPS进行所有通信
• 对输入和输出数据进行清理

许可证

MIT