Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client