使用说明

项目简介

Summarization Functions 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为 AI Agent 提供强大的文本摘要能力。该服务器通过简洁的架构，实现了对多种类型文本内容的智能摘要，帮助 AI Agent 在处理大量信息时，更有效地利用上下文窗口，提升性能和可靠性。

主要功能点

命令输出摘要: 执行命令并快速总结其输出结果，提炼关键信息。
文件内容分析: 总结单个或多个文件的内容，快速理解文件要点。
目录结构理解: 清晰概括目录结构，方便 AI Agent 快速了解项目的文件组织。
灵活的模型支持: 支持来自不同 AI 提供商的模型，如 Anthropic, OpenAI, Google。
AI Agent 上下文优化: 通过智能摘要，有效防止上下文窗口溢出，提升 AI Agent 性能。

安装步骤

通过 npm 安装:

npm i mcp-summarization-functions

服务器配置

要使用 Summarization Functions MCP 服务器，您需要在 MCP 客户端配置文件中添加以下服务器配置信息。这段 JSON 配置描述了客户端如何启动和连接到摘要服务器。

{
  "mcpServers": {
    "MUST_USE_summarization": {
      "command": "node",
      "args": ["path/to/summarization-functions/build/index.js"],
      "env": {
        "PROVIDER": "ANTHROPIC", // 必填: AI 提供商，可选值: ANTHROPIC, OPENAI, OPENAI-COMPATIBLE, GOOGLE
        "API_KEY": "your-api-key", // 必填: 所选 AI 提供商的 API 密钥
        "MODEL_ID": "claude-3-5-sonnet-20241022", // 可选: 指定使用的模型 (provider-specific)，默认为提供商的标准模型
        "MCP_WORKING_DIR": "default_working_directory" // 可选: 文件操作的默认工作目录，默认为根目录 '/'
      }
    }
  }
}

配置参数说明:

'"MUST_USE_summarization"': 您为该服务器配置在 MCP 客户端中自定义的名称。
'"command": "node"': 指定使用 Node.js 启动服务器。
'"args": ["path/to/summarization-functions/build/index.js"]': 'node' 命令的参数数组。您需要将 '"path/to/summarization-functions/build/index.js"' 替换为实际的服务器 'index.js' 文件路径。该路径通常位于 'node_modules/mcp-summarization-functions/build/' 目录下，相对于您的 MCP 客户端配置文件。
'"env"': 定义服务器运行所需的环境变量。
- '"PROVIDER"': 必填。指定用于摘要的 AI 提供商。支持的值包括 'ANTHROPIC', 'OPENAI', 'OPENAI-COMPATIBLE', 和 'GOOGLE'。
- '"API_KEY"': 必填。您从所选 AI 提供商处获得的 API 密钥。
- '"MODEL_ID"': 可选。允许您指定来自所选提供商的特定模型。如果未设置，将使用提供商的默认模型。请查阅您选择的提供商的文档以获取有效的模型 ID。
- '"MCP_WORKING_DIR"': 可选。设置服务器执行文件相关操作时使用的默认工作目录，尤其是在处理 'summarize_files' 和 'summarize_directory' 等工具中的相对文件路径时。如果未设置，将使用根目录 '/' 作为后备，这可能会导致权限问题或意外行为。建议根据您的用例设置适当的工作目录。

基本使用方法

服务器配置并运行后，您可以通过 MCP 客户端使用以下工具:

'summarize_command': 总结命令输出。
'summarize_files': 总结一个或多个文件的内容。
'summarize_directory': 提供目录结构的摘要。
'summarize_text': 总结任意文本内容。
'get_full_content': 使用摘要 ID 检索先前摘要的完整内容。

请参考 README 文档中 "Available Functions" 部分，了解工具的详细参数信息。

关键词

使用说明

信息