{"id":29855868,"url":"https://github.com/keides2/futurevuls-mcp","last_synced_at":"2026-02-07T12:31:47.157Z","repository":{"id":307125947,"uuid":"1024548499","full_name":"keides2/futurevuls-mcp","owner":"keides2","description":"Model Context Protocol for FutureVuls","archived":false,"fork":false,"pushed_at":"2025-11-02T04:03:57.000Z","size":3926,"stargazers_count":0,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-02T04:13:10.535Z","etag":null,"topics":["ai","ai-agent","api-integration","claude","cybersecurity","javascript","llm","mcp","mcp-server","model-context-protocol","nodejs","security","vulnerability-management","windows"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/keides2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-22T22:03:31.000Z","updated_at":"2025-11-02T04:02:16.000Z","dependencies_parsed_at":"2025-07-29T17:01:52.040Z","dependency_job_id":"fd85cbb6-8677-45c1-abf4-2fe96f6092b1","html_url":"https://github.com/keides2/futurevuls-mcp","commit_stats":null,"previous_names":["keides2/futurevuls-mcp"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/keides2/futurevuls-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keides2%2Ffuturevuls-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keides2%2Ffuturevuls-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keides2%2Ffuturevuls-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keides2%2Ffuturevuls-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/keides2","download_url":"https://codeload.github.com/keides2/futurevuls-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keides2%2Ffuturevuls-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29194019,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-07T07:37:03.739Z","status":"ssl_error","status_checked_at":"2026-02-07T07:37:03.029Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agent","api-integration","claude","cybersecurity","javascript","llm","mcp","mcp-server","model-context-protocol","nodejs","security","vulnerability-management","windows"],"created_at":"2025-07-29T23:23:42.219Z","updated_at":"2026-02-07T12:31:47.151Z","avatar_url":"https://github.com/keides2.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FutureVuls MCP Server (Windows Edition - Node.js)\n\n![FutureVuls MCP](./img/top.png)\n\n**English** | [日本語](README_ja.md)\n\n\u003cdiv align=\"center\"\u003e\n\n**Model Context Protocol (MCP) server for FutureVuls vulnerability management service integration**\n\n\u003c/div\u003e\n\n---\n\n## Overview\n\nThis project is a Windows-based server that provides access to the \u003cimg src=./img/future_vuls.png width=\"10%\"\u003eFutureVuls API through the \u003cimg src=./img/modelcontextprotocol.png width=\"10%\"\u003eModel Context Protocol (MCP). It enables AI assistants like Claude to directly utilize vulnerability management functions.\n\n### 🎯 Key Features\n\n- **🔍 Vulnerability Management**: Search and display detailed CVE information\n- **📋 Task Management**: Check and manage vulnerability response tasks\n- **🖥️ Server Management**: List and display details of monitored servers\n- **📊 Report Generation**: Automated weekly report generation\n- **💓 Health Check**: FutureVuls API connection verification\n\n## System Requirements\n\n- **OS**: Windows 10/11 (64bit)\n- **Node.js**: 18.0 or higher (LTS recommended)\n- **npm**: Included with Node.js\n- **Claude Desktop**: Latest version\n- **Memory**: 4GB or more recommended\n- **Storage**: 1GB or more free space\n\n## Setup\n\n\u003e Note: DXT packaging is not currently supported. We recommend installing and running via npm (global command) for simplicity and reliability.\n\n### 🚀 Quick install (Recommended)\n\n```cmd\nnpm install -g @keides2/futurevuls-mcp\n```\n\nOr if you have a local tarball (offline/distribution):\n\n```cmd\nnpm install -g .\\keides2-futurevuls-mcp-2.1.0.tgz\n```\n\nThen you can run the server as a CLI:\n\n```cmd\nfuturevuls-mcp\n```\n\n### 📦 1. Clone the Repository\n\n```cmd\ngit clone https://github.com/keides2/futurevuls-mcp.git\ncd futurevuls-mcp\n```\n\n### 🛠️ 2. Automated Setup (Recommended)\n\n```cmd\nscripts\\setup_windows.bat\n```\n\nThis script automatically performs the following:\n\n- Node.js environment verification\n- npm dependency installation\n- Configuration file template creation\n- Claude Desktop configuration file creation\n\n### ⚙️ 3. Manual Setup\n\n#### Install Node.js Dependencies\n\n```cmd\nnpm install\n```\n\n#### Create Configuration Files\n\n```bash\ncopy .env.sample .env\ncopy templates\\groups.json.template groups.json\n\n# Be careful not to overwrite when using other MCPs\ncopy templates\\claude_desktop_config.json.template \"%APPDATA%\\Claude\\claude_desktop_config.json\"\n```\n\n### 🔧 4. Edit Configuration Files\n\n#### Configure .env File\n\nOpen the `.env` file with Notepad or VS Code and configure the following:\n\n```bash\n# FutureVuls API Configuration (Required)\nFUTUREVULS_API_TOKEN=your_actual_api_token_here\n\n# Debug Mode (Optional)\nFUTUREVULS_DEBUG=false\n```\n\n#### Configure groups.json File\n\nThe `groups.json` file can be placed in any of the following locations (**in priority order**):\n\n1. **Current Directory** - The directory where the command is executed (most convenient)\n2. **Script Directory** - The directory where `futurevuls-mcp.js` is located\n3. **Home Directory** - `C:\\Users\\[USERNAME]\\groups.json`\n\nCreate/edit the `groups.json` file with Notepad or VS Code and set your actual group information in the following format:\n\n```json\nGroup Name: [\n  \"Group Token\",\n  \"Group ID\",\n  \"Number of Vulnerabilities\"\n]\n```\n\n**Example:**\n\n```json\n{\n    \"group\": [\n        {\n            \"Production Environment\": [\n                \"fvgs-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\n                123,\n                1500\n            ]\n        },\n        {\n            \"Development Environment\": [\n                \"fvgs-yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy\", \n                456,\n                800\n            ]\n        },\n        {\n          ...\n        }\n    ]\n}\n```\n\n\u003e **💡 Tip**: For npm global installations, placing `groups.json` in Claude Desktop's working directory (typically `C:\\Users\\[USERNAME]`) is the easiest approach.\n\n### 🤖 5. Claude Desktop Configuration\n\n#### Configuration File Location\n\n```bash\n%APPDATA%\\Claude\\claude_desktop_config.json\n```\n\n**Access via File Explorer:**\n\n1. Press `Win + R` keys\n2. Type `%APPDATA%\\Claude` and press Enter\n3. Edit `claude_desktop_config.json`\n\n#### Configuration Method (Using Template)\n\n**Method 1: Copy Template (Recommended)**\n\n```bash\n# Be careful not to overwrite when using other MCPs\ncopy templates\\claude_desktop_config.json.template \"%APPDATA%\\Claude\\claude_desktop_config.json\"\n```\n\n**Method 2: Manual File Creation**\nCreate `%APPDATA%\\Claude\\claude_desktop_config.json` using Notepad or VS Code\n\n#### Edit Configuration Content\n\nPreferred (npm global command):\n\n```json\n{\n  \"mcpServers\": {\n    \"futurevuls\": {\n      \"command\": \"futurevuls-mcp\",\n      \"args\": [],\n      \"env\": {\n        \"FUTUREVULS_API_TOKEN\": \"your_actual_api_token_here\"\n      }\n    }\n  }\n}\n```\n\nAlternative (direct Node path, if not using global install):\n\n```json\n{\n  \"mcpServers\": {\n    \"futurevuls\": {\n      \"command\": \"node\",\n      \"args\": [\"C:\\\\Users\\\\[USERNAME]\\\\path\\\\to\\\\futurevuls-mcp\\\\futurevuls-mcp.js\"],\n      \"env\": {\n        \"FUTUREVULS_API_TOKEN\": \"your_actual_api_token_here\"\n      }\n    }\n  }\n}\n```\n\n**⚠️ Important Notes for Path Specification:**\n\n- Use **absolute paths**\n- Escape backslashes with `\\\\` (use `\\\\` instead of `\\`)\n- Replace with your actual installation path\n- **File name is `futurevuls-mcp.js`** (not Python)\n- Avoid paths containing Japanese characters\n\n## Usage and Operation Verification\n\n### 💡 About MCP Server Operation\n\n**AI assistants like Claude Desktop automatically communicate with the MCP server after configuration.** \nThe manual startup methods below are primarily for **configuration verification, troubleshooting, and development purposes**.\n\n### 🔍 1. Verification - Start with Batch File\n\n```cmd\nstart_mcp.bat\n```\n\n**Use Cases**:\n\n- Operation verification before Claude Desktop configuration\n- Detailed error message confirmation\n- Log output monitoring\n\n### 🔍 2. Verification - Run via npm global command\n\n```cmd\nfuturevuls-mcp\n```\n\n### 🔍 3. Verification - Direct Node.js Execution\n\n```cmd\nnode futurevuls-mcp.js\n```\n\n**Use Cases**:\n\n- Detailed debug information confirmation\n- npm dependency issue identification\n- Development and testing operation verification\n\n### ✅ How to Verify Normal Operation\n\n**1. Manual Startup Verification**\nIf the following messages appear at startup, it's working normally:\n\n```cmd\nFutureVuls MCP Server starting...\nListening on stdio...\nServer initialized successfully\n```\n\n**2. Claude Desktop Verification**\n\n- Restart Claude Desktop\n- Type something like \"Check FutureVuls vulnerabilities\"\n- If MCP tools are recognized and executed, it's successful\n\n## DXT Distribution (currently unsupported) — reasons\n\nAt present, distributing/running this server in DXT format is not officially supported due to stability concerns. As a workaround, please use the npm global command (futurevuls-mcp) or run directly with Node.js as described above.\n\n### Symptoms\n\n- In Claude Desktop's UtilityProcess environment, after initialization the following intermittently occur:\n  - -32001 Request timed out\n  - Unexpected server transport closed\n- On the same machine, direct Node execution and Content-Length smoke tests succeed (not reproducible)\n\n### Actions Taken\n\n- Rewrote the JSON-RPC stdin parser to support:\n  - Content-Length framing (LSP-style) and JSON Lines\n  - Flexible header termination detection (CRLFCRLF/LFLF)\n  - Response framing that matches the input style\n- Simplified initialize response and metadata, bumped versions, and repackaged multiple times\n- Reinstalled DXT package, changed install locations (different drive/ASCII-only paths), re-enabled extensions, etc.\n- Timeouts/closures still persisted only on some environments\n\n### Current Assessment\n\nWe suspect environment-specific behavior related to UtilityProcess stdio/lifecycle in certain setups, which prevents us from guaranteeing stability via DXT. In contrast, the npm global command approach has been stable and is operationally simple, so we recommend it as the official method.\n\n### Policy\n\n- Officially supported: npm global command (futurevuls-mcp)\n- Alternative: direct Node execution (for development/verification)\n- DXT: will be revisited as upstream behavior improves; any progress will be announced in README/release notes\n\n## API Function List\n\n| Function | Description | Claude Usage Example |\n|----------|-------------|---------------------|\n| `futurevuls_health_check` | API health check | \"Check FutureVuls connection status\" |\n| `futurevuls_list_groups` | Get group list | \"Show me monitored groups\" |\n| `futurevuls_get_cves` | Get CVE list | \"Display latest vulnerability list\" |\n| `futurevuls_get_cve_detail` | Get CVE details | \"Tell me details of CVE-2023-12345\" |\n| `futurevuls_get_tasks` | Get task list | \"Are there any tasks to handle?\" |\n| `futurevuls_get_task_detail` | Get task details | \"Check details of task 123\" |\n| `futurevuls_get_servers` | Get server list | \"Show list of monitored servers\" |\n| `futurevuls_get_groupset_servers` | Get groupset servers | \"Show servers in groupset\" |\n| `futurevuls_get_group_members` | Get group members | \"Show members of group 123\" |\n| `futurevuls_get_org_groups` | Get organization groups | \"List all organization groups\" |\n| `futurevuls_get_org_members` | Get organization members | \"Show organization members\" |\n| `futurevuls_search_critical_cves` | Search high-severity CVEs | \"Extract CRITICAL vulnerabilities\" |\n| `futurevuls_generate_weekly_report` | Generate weekly report | \"Generate this week's vulnerability report\" |\n\n## File Structure\n\n```text\nfuturevuls-mcp/\n├── 📄 futurevuls-mcp.js           # Main MCP Server script\n├── 📦 package.json                # Node.js dependencies and metadata\n├── 🔧 .env.sample                 # Environment variable template\n├── 📖 README.md                   # This file (English)\n├── 📖 README_ja.md                # Japanese README\n├── 📜 LICENSE                     # MIT License\n├── 📁 docs/                       # Documentation directory\n│   ├── 📁 setup/                  # Setup guides\n│   ├── 📁 guides/                 # User guides\n│   ├── 📁 releases/               # Release notes\n│   └── 📄 api_sample.txt          # API usage examples\n├── 📁 scripts/                    # Setup and test scripts\n│   ├── ⚙️ setup_windows.bat       # Windows automated setup\n│   └── 🧪 test-health.js          # Health check script\n├── 📁 templates/                  # Configuration templates\n│   ├── 📊 groups.json.template    # Group configuration template\n│   └── 🤖 claude_desktop_config.json.template # Claude Desktop config template\n├── 📁 archive/                    # Legacy files and old versions\n│   ├── 📄 futurevuls-mcp-legacy.js # Legacy MCP Server (for VSCode + Cline)\n│   ├── 📦 package.*.json          # Old package configurations\n│   └── 📦 *.tgz                   # Previous release packages\n├── 🖼️ img/                        # Images for documentation\n├── 📁 dxt-init/                   # DXT packaging experiments (deprecated)\n└── 📁 evac/                       # Development and backup files\n```\n\n### 🔧 About Server Files\n\n**futurevuls-mcp.js** (Main)\n\n- For Claude Desktop use\n- Latest MCP protocol version (2024-11-05)\n- Recommended for general use\n- Supports flexible groups.json placement\n\n**archive/futurevuls-mcp-legacy.js** (Legacy)  \n\n- For VSCode + Cline use\n- Legacy MCP protocol version (2024-11-05)\n- Use when the main version is incompatible\n\n## Security Considerations\n\n⚠️ **Important**: The following files contain sensitive information and should not be shared with third parties:\n\n- `.env` (environment variables and API tokens)\n- `groups.json` (actual group configuration)\n- `claude_desktop_config.json` (actual Claude Desktop configuration)\n\n---\n\n## Note\n\nThis project is designed for use with Node.js on Windows environments.\n\n---\n2025/07/29 keides2 Node.js version support\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkeides2%2Ffuturevuls-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkeides2%2Ffuturevuls-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkeides2%2Ffuturevuls-mcp/lists"}