返回 MCP 目录
public公开dns本地运行

enrichment-mcp

一个基于Model Context Protocol (MCP)的服务器,用于通过第三方服务(如VirusTotal、HybridAnalysis等)对提供的可观察对象(如IP地址、域名等)进行富化查询。该项目目前仅用于开发测试,支持多种可观察对象类型和第三方服务,并采用环境变量管理API密钥以确保安全性。

article

README

🚀 Enrichment MCP 项目

本项目是一个用于增强上下文(Enrichment)的 Model Context Protocol (MCP) 服务器,主要提供 IP 查询和域名查询功能,能够通过输入 IP 地址或域名来查询相关信息。

🚀 快速开始

安装步骤

克隆仓库

git clone git@github.com:yourusername/enrichment-mcp.git

安装依赖项

进入项目目录后,安装所需的 Python 包:

pip install -r requirements.txt

配置文件

创建一个配置文件 config.json,并添加以下内容:

{
    "ip": {
        "enable": true,
        "apikey": "your_api_key_here",
        "apisecretkey": "your_api_secret_key_here"
    },
    "domain": {
        "enable": true,
        "apikey": "your_api_key_here",
        "apisecretkey": "your_api_secret_key_here"
    }
}

使用说明

下载预构建服务器

有关使用预构建服务器的说明,请参阅:https://modelcontextprotocol.io/quickstart/user

下载并安装 Claude for Desktop
curl -LsSf https://astral.sh/uv/install.sh | sh
配置 Claude for Desktop
  1. 打开 Claude for Desktop 的设置。
  2. 在开发者选项中编辑配置文件:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  3. 将以下内容添加到配置文件中:
{
    "mcpServers": {
        "enrichment-mcp": {
            "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/CLONED/REPOSITORY/enrichment-mcp",
                "run",
                "server.py"
            ]
        }
    }
}
  1. 重新启动 Claude for Desktop。

现在,您应该会在聊天栏中看到两个图标:一个锤子(显示可用工具)和一个连接图标(显示定义的提示和输入要求)。

✨ 主要特性

  • IP 查询:支持通过输入 IP 地址查询相关信息。
  • 域名查询:支持通过输入域名查询相关信息。

🔧 技术细节

在构建这个服务器的过程中,开发者学习了 astral 的 uv 以及 MCP。虽然可能存在过度设计的情况,但整个过程十分有趣。同时,开发者考虑到了未来的用途,因此尝试以更通用的方式进行设计(更多细节即将推出)。

此外,特别选择使用 Jinja2 模板,因为这可以更好地管理返回的提示/结果,并为未来用例提供更多灵活性。

🤝 贡献指南

欢迎贡献!请随时提交拉取请求。

⚠️ 免责声明

此工具仅用于教育和授权测试目的。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端