社交监听服务器

一个基于Model Context Protocol (MCP)的生产就绪服务器,用于通过Mention API进行社交监听和监控,支持多种工具和功能。

  • by MaelitoP
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 maelitop/mention-mcp-server

使用说明

提及MCP服务器

生产准备就绪 模型上下文协议(MCP) 通过Mention API进行社交监听和监控的服务器。采用TypeScript、全面的错误处理、结构化日志和模块化架构构建。

支持的工具

工具 说明
get_account_info 检索帐户详细信息和订阅计划
get_app_data 获取可用的语言、国家和来源
list_alerts 列出所有带分页的监控警报
get_alert 获取有关特定警报的详细信息
create_basic_alert 通过简单的关键字匹配创建警报
create_advanced_alert 使用布尔查询语法创建警报
update_alert 修改现有警报条件和设置
pause_alert 暂时暂停对特定警报的监控
unpause_alert 恢复对暂停警报的监视
fetch_mentions 使用高级过滤检索提及
fetch_alert_stats 获取警报的全面统计数据

安装与使用

Claude Desktop快速入门

将以下内容添加到您的Claude Desktop配置文件中:

{
  "mcpServers": {
    "mention": {
      "command": "npx",
      "args": ["-y", "@maelitop/mention-mcp-server"],
      "env": {
        "MCP_MENTION_API_KEY": "your_mention_api_key_here"
      }
    }
  }
}

环境变量

变量 描述 默认值
MCP_MENTION_API_KEY 您提到的API密钥(必需) -
MCP_MENTION_API_BASE_URL 自定义API基础URL https://web.mention.com/api
MCP_LOG_LEVEL 日志记录级别(debug, info, warn, error) info
MCP_CONSOLE_LOGGING 启用控制台日志记录(true/false) false
MCP_REQUEST_TIMEOUT 请求超时(毫秒) 30000
MCP_MAX_RETRIES 最大重试次数 3

发展

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Build for production
npm run build

# Run linting and type checking
npm run ci

日志记录

日志会自动写入特定于平台的目录:

  • macOS: ~/Library/Logs/mention-mcp-server/mention-mcp-server.log
  • 视窗: ~/AppData/Local/mention-mcp-server/logs/mention-mcp-server.log
  • Linux: ~/.local/share/mention-mcp-server/logs/mention-mcp-server.log

测试

# Run all tests
npm test

# Run tests with coverage
npm run test:coverage

# Run tests in watch mode
npm run test -- --watch

许可证

该项目根据 MIT许可证.