星战科技xingzhan.cloud
返回市场
全视界-mcp服务器

全视界-mcp服务器

作者：yzfly11 星标更新：2025-06-19
安装使用来源：spider==github.com

项目介绍

FullScope-MCP

内容摘要操作MCP服务器，支持诸如网络爬虫、文件读取、内容摘要、主题摘要等功能。

<a href="https://glama.ai/mcp/servers/@yzfly/fullscope-mcp-server"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=3883490075,429563271&fm=3081&app=3081&f=PNG?w=760&h=400" alt="FullScope-MCP MCP服务器" /> </a>

🌟 特性

FullScope MCP是一款专为内容摘要和操作场景设计的综合模型上下文协议（MCP）服务器。支持以下核心功能：

  1. 🤖 模型调用 直接调用大型语言模型进行回答
  2. 🌐 网络捕获 抓取网页内容，可选择保存为txt文本文件
  3. 📝 内容摘要 将任何内容摘要为指定长度（默认原始内容的20%，去水版本）
  4. 🔗 网页摘要 获取网页内容并自动摘要为精炼版本
  5. 📄 文本文件摘要 读取txt等格式的文本文件并摘要其内容（限返回2k字符）
  6. 📚 PDF文件摘要 读取PDF文件并摘要文本内容（限2k字符）
  7. 🎯 主题摘要 类似于RAG功能，给定信息内容和查询主题，返回最相关内容的摘要（限2k字符）

📦 安装

使用UVX安装（推荐）

uvx fullscope-mcp-server

使用pip安装

pip install fullscope-mcp-server

从源代码安装

git clone https://github.com/yzfly/fullscope-mcp
cd fullscope-mcp
pip install -e .

⚙️ 配置

环境变量配置

在使用前，需要配置以下环境变量：

必要配置

# MiniMax API密钥（必需）
export OPENAI_API_KEY="your-minimax-api-key"

可选配置

# API基础URL（默认使用MiniMax）
export OPENAI_BASE_URL="https://api.minimaxi.com/v1"

# 使用的模型（默认MiniMax-M1）
export OPENAI_MODEL="MiniMax-M1"

# 输入上下文最大token数（默认120000）
export MAX_INPUT_TOKENS="120000"

# 输出上下文最大token数（默认8000）
export MAX_OUTPUT_TOKENS="8000"

Claude Desktop配置

当使用Claude Desktop时，请在claude_desktop_config.json中添加以下配置：

{
  "mcpServers": {
    "fullscope-mcp": {
      "command": "uvx",
      "args": ["fullscope-mcp-server"],
      "env": {
        "OPENAI_API_KEY": "your-minimax-api-key-here",
        "OPENAI_BASE_URL": "https://api.minimaxi.com/v1",
        "OPENAI_MODEL": "MiniMax-M1",
        "MAX_INPUT_TOKENS": "900000",
        "MAX_OUTPUT_TOKENS": "8000"
      }
    }
  }
}

或者使用pip安装版本：

{
  "mcpServers": {
    "fullscope-mcp": {
      "command": "python",
      "args": ["-m", "fullscope_mcp_server"],
      "env": {
        "OPENAI_API_KEY": "your-minimax-api-key-here",
        "OPENAI_BASE_URL": "https://api.minimaxi.com/v1",
        "OPENAI_MODEL": "MiniMax-M1",
        "MAX_INPUT_TOKENS": "900000",
        "MAX_OUTPUT_TOKENS": "8000"
      }
    }
  }
}

🚀 使用说明

1. 模型调用

# 工具名: call_model
# 参数: prompt (str) - 要发送给模型的提示词
# 返回: 模型的回答

2. 网络爬虫

# 工具名: scrape_webpage
# 参数:
#   - url (str) - 要抓取的网页URL
#   - save_to_file (bool) - 是否保存内容到txt文件
# 返回: 抓取结果和文件路径（如果保存）

3. 内容摘要

# 工具名: summarize_content
# 参数:
#   - content (str) - 要总结的内容
#   - target_ratio (float) - 目标压缩比例，0.1-1.0之间，默认0.2
# 返回: 总结后的内容

4. 网页摘要

# 工具名: summarize_webpage
# 参数:
#   - url (str) - 要抓取和总结的网页URL
#   - target_ratio (float) - 目标压缩比例，默认0.2
# 返回: 网页内容总结

5. 文本文件摘要

# 工具名: read_and_summarize_text_file
# 参数:
#   - filepath (str) - 文本文件路径
#   - target_ratio (float) - 目标压缩比例，默认0.2
# 返回: 文件内容总结

6. PDF文件摘要

# 工具名: read_and_summarize_pdf_file
# 参数:
#   - filepath (str) - PDF文件路径
#   - target_ratio (float) - 目标压缩比例，默认0.2
# 返回: PDF内容总结

7. 主题摘要

# 工具名: topic_based_summary
# 参数:
#   - content (str) - 资料内容
#   - query (str) - 查询的主题或问题
# 返回: 基于主题的相关内容总结（2k字符内）

📖 使用示例

使用Claude Desktop

  1. 网页内容摘要

    请帮我总结这个网页的内容：https://example.com/article

  2. 文档摘要

    请读取并总结这个PDF文件：/path/to/document.pdf

  3. 主题分析

    基于这段资料内容，帮我分析“人工智能发展趋势”相关的信息

直接运行服务器

# 设置环境变量
export OPENAI_API_KEY="your-api-key"

# 运行服务器
python fullscope_mcp_server.py

🔧 开发指南

项目结构

fullscope-mcp/
├── src/
│   └── fullscope_mcp_server/
│       ├── __init__.py
│       └── server.py
├── README.md
├── pyproject.toml
└── LICENSE

本地开发

# 克隆项目
git clone https://github.com/yzfly/fullscope-mcp
cd fullscope-mcp

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装开发依赖
pip install -e ".[dev]"

# 运行测试
pytest

代码格式化

# 格式化代码
black src/
isort src/

# 类型检查
mypy src/

🌐 支持的模型

此服务器主要设计用于MiniMax API，但通过配置OPENAI_BASE_URL及相关参数也可以支持其他兼容OpenAI API格式的模型服务：

  • MiniMax-M1（默认推荐）
  • MiniMax-Text-01
  • 其他支持OpenAI API格式的服务

MiniMax API配置说明

MiniMax API支持的最大上下文长度为1000192个token，使其非常适合处理长文档和大量内容的摘要任务。

🚀 发布至PyPI步骤

1. 准备发布

# 安装构建工具
pip install build twine

# 构建包
python -m build

# 检查包
twine check dist/*

2. 发布至TestPyPI（测试）

# 上传至TestPyPI
twine upload --repository testpypi dist/*

# 从TestPyPI安装测试
pip install --index-url https://test.pypi.org/simple/ fullscope-mcp-server

3. 发布至官方PyPI

# 上传至PyPI
twine upload dist/*

📝 更新日志

v1.0.0 (2024-12-19)

  • ✨ 首次发布
  • 🌐 支持网络爬虫和保存
  • 📝 支持内容摘要（可配置压缩比）
  • 📄 支持读取和摘要文本及PDF文件
  • 🎯 支持主题摘要（RAG功能）
  • 🤖 支持直接模型调用
  • ⚙️ 完整环境变量配置
  • 📦 支持UVX和PIP安装

🤝 贡献

欢迎提交Issue和Pull Requests！

  1. 分叉此项目
  2. 创建功能性分支（git checkout -b feature/AmazingFeature）
  3. 提交更改（git commit -m 'Add some AmazingFeature'）
  4. 推送到分支（git push origin feature/AmazingFeature）
  5. 打开Pull Request

📄 许可证

此项目采用MIT许可证 - 查看LICENSE文档详情。

👨‍💻 作者

yzfly

🙏 致谢

❓ 常见问题

Q: 如何获取MiniMax API密钥？

A: 访问MiniMax开放平台注册账户后，在账户管理界面获取密钥。

Q: 可以使用其他模型吗？

A: 可以！通过配置OPENAI_BASE_URL和OPENAI_MODEL环境变量，可以使用任何兼容OpenAI API格式的模型服务。

Q: 有文件大小限制吗？

A: 是的，为了性能原因：

  • 文本文件和PDF文件的内容限制约为120k字符
  • 网页内容将根据模型的上下文限制自动截断
  • 主题摘要结果限制为2k字符或更少

Q: 如何使用Claude Desktop？

A: 根据上述配置说明，在claude_desktop_config.json文件中添加配置，然后简单地重启Claude Desktop即可。

如果您认为此项目有用，请提供一个⭐ 星级评价！