Tinder API接口服务器

一个为Tinder API提供标准化接口的MCP服务器,支持认证管理、请求处理、速率限制和缓存等功能,适用于需要集成Tinder API的应用开发。

  • by glassBead-tc
  • TypeScript
  • 本地部署
  • 26 星标
  • 更新于
在 GitHub 查看 glassBead-tc/tinder-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
    
  2. 安装依赖项:

    npm install
    
  3. 创建一个 .env 文件基于 .env.example:

    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:验证验证码
  • 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
  • 对输入和输出数据进行消毒

许可证

麻省理工学院