Tinder API MCP Server

Tinder API MCP服务器

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

概述

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

特性

• 认证管理：支持短信和脸书身份验证方法
• 请求处理：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

1. 安装依赖项：

   npm install

1. 创建一个 .env 文件基于 .env.example:

   cp .env.example .env

1. 编辑 .env 文件中包含您的配置设置。

发展

1. 启动开发服务器：

   npm run dev

1. 构建项目：

   npm run build

1. 运行生产服务器：

   npm start

1. 运行测试：

   npm test

API终点

认证

• POST /mcp/auth/sms/send：发送短信验证码
• POST /mcp/auth/sms/validate：验证短信验证码
• POST /mcp/auth/facebook：通过Facebook进行身份验证
• POST /mcp/auth/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：验证验证验证码响应
• 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
• 对输入和输出数据进行消毒

许可证

麻省理工学院