项目简介

'ap-mcp-server' 是一个非官方的 Model Context Protocol (MCP) 服务器,它将 Associated Press (AP) 媒体API封装成一个专为AI应用设计的内容智能资源。通过提供26个强大的工具和17个智能Prompt模板,该服务器使得LLM客户端能够通过自然语言无缝地访问、分析并管理AP的全面新闻内容。

主要功能点

  • 内容访问与搜索: 允许LLM通过多种方式搜索和获取AP新闻内容,包括高级搜索、实时内容 Feed、RSS订阅及按需内容。支持根据主题、位置、时间范围和媒体类型进行灵活筛选。
  • AI智能优化: 提供自然语言查询处理,将对话式查询转化为优化的API搜索;智能Prompt模板简化复杂操作;AI驱动的内容推荐、趋势分析、智能查询优化和错误恢复机制,增强AI与新闻内容的交互体验。
  • 内容监控与警报: 支持创建、管理和查询内容监控器,为LLM提供自动化新闻警报和数据流监控能力,可根据特定条件触发通知。
  • 批量操作与性能: 优化了批量内容获取和搜索,支持自动分页处理多达2000条结果,并采用智能缓存系统(基于TTL)以提高性能和响应速度。
  • 企业级基础: 基于TypeScript实现,提供全面的类型安全、健壮的错误处理和安全配置,支持Stdio等多种传输协议,为LLM应用提供稳定、可扩展的上下文服务框架。

安装步骤

  1. 安装Node.js: 确保您的系统已安装 Node.js 18 或更高版本。您可以通过访问 nodejs.org 下载并安装。
  2. 获取AP API密钥: 访问 Associated Press 开发者网站(api.ap.org)获取您的 Associated Press API密钥。这是连接AP媒体API的必要凭证。

服务器配置 (MCP客户端使用)

MCP服务器通过标准输入/输出 (stdio) 方式与MCP客户端通信。以下是您在MCP客户端配置中添加此服务器的示例(请根据您的MCP客户端的文档进行调整)。

{
    "mcpServers": {
        "ap-media": {
            "type": "stdio",
            "command": "npx",
            "args": ["-y", "ap-mcp-server@latest"],
            "env": {
                "AP_API_KEY": "您的AP_API_KEY_在此处",
                // AP_API_KEY 是必填项,用于认证AP媒体API
                // 可选配置项:
                // "AP_BASE_URL": "https://api.ap.org/media/v" (AP API基础URL,默认值)
                // "AP_TIMEOUT": "30000" (请求超时时间,毫秒,默认30000)
                // "AP_RETRIES": "3" (失败请求重试次数,默认3)
                // "AP_ENFORCE_PLAN": "true" (是否强制所有内容请求仅返回您计划内的内容,默认为true)
                // "AP_DEBUG": "false" (是否启用调试日志,默认为false)
                // "AP_LOG_LEVEL": "info" (日志级别: error, warn, info, debug,默认为info)
                // "AP_VERBOSE_LOGGING": "false" (是否启用请求/响应详细日志,默认为false)
                // "AP_CACHE_ENABLED": "true" (是否启用智能缓存系统,默认为true)
                // "AP_CACHE_TTL_TRENDS": "300000" (趋势主题缓存TTL,毫秒,默认5分钟)
                // "AP_CACHE_TTL_SEARCH": "180000" (搜索结果缓存TTL,毫秒,默认3分钟)
            }
        }
    }
}

基本使用方法

配置完成后,您的MCP客户端(如Claude Code CLI、VS Code扩展、Claude Desktop、ChatGPT Desktop等)即可通过自然语言与AP MCP服务器进行交互。服务器会根据LLM的指令,自动调用相应的工具或Prompt来完成任务。

  • 示例1: 搜索新闻 LLM客户端: "查找关于人工智能在医疗领域的最新文章" (MCP服务器会自动将此请求转化为 'search_content' 工具调用,并返回相关新闻文章。)

  • 示例2: 获取趋势话题 LLM客户端: "显示本周科技领域的热门话题" (MCP服务器会调用 'analyze_content_trends' 或 'get_trending_subjects' 工具,返回科技趋势分析报告。)

  • 示例3: 创建新闻监控器 LLM客户端: "设置一个关于气候变化突发新闻的监控器,发送到 [email protected]" (MCP服务器会调用 'create_news_monitor' 工具,根据指定主题和邮箱创建自动化警报。)

  • 示例4: 生成每日新闻简报 LLM客户端: "生成一份关于商业和政治的每日新闻简报" (MCP服务器会调用 'daily-news-briefing' Prompt,聚合突发新闻、趋势和推荐内容,生成一份综合简报。)

通过这些强大的工具和预设Prompt,LLM可以高效地获取、分析并利用AP的丰富新闻数据,极大地提升AI应用的内容智能和交互能力。

信息

分类

AI与计算