estcarisimo/netcores-mcp
If you are the rightful owner of netcores-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
NetCores MCP is a Model Context Protocol server designed to enhance LLMs with advanced network analysis capabilities, utilizing the NetCores k-core decomposition API for real-time Internet topology insights.
NetCores MCP
NetCores MCP is a Model Context Protocol (MCP) server that provides LLMs with powerful network analysis capabilities through the NetCores k-core decomposition API. Connect Claude Desktop to real-time AS (Autonomous System) relationship data and Internet topology analysis.
🌐 Live Demo: netcores.fi.uba.ar | 📖 Full Docs: MCP Integration Guide
🚀 Quick Installation
Method 1: NPM Registry (Recommended)
# Once published to npm
npm install -g netcores-mcp
netcores-mcp --setup
Method 2: Install from GitHub
# Install directly from GitHub repository
npm install -g https://github.com/estcarisimo/netcores-mcp.git
# Setup Claude Desktop (interactive)
netcores-mcp --setup
# Test everything works
netcores-mcp --test-all
Method 3: Clone and Install
# Clone the repository
git clone https://github.com/estcarisimo/netcores-mcp.git
cd netcores-mcp
# Install globally
npm install -g .
# Setup Claude Desktop
netcores-mcp --setup
✅ Verify Installation
After installation, restart Claude Desktop and ask:
"What tools do you have available?"
You should see 8 NetCores tools listed! Then try:
"Check the health of the NetCores system"
"Analyze Google's ASN 15169 k-core trends over the past year"
🛠️ Features
🌐 Network Analysis Tools
NetCores MCP provides 8 powerful tools for Internet topology analysis:
- Health Check - System status and availability
- Data Summary - Overview of available IPv4/IPv6 data
- ASN Trend Analysis - k-core shell index trends for individual ASNs
- Multiple ASN Comparison - Compare trends across multiple ASNs
- Network Snapshots - Available CAIDA AS-relationship snapshots
- Data Refresh - Trigger updates from CAIDA sources
- Scheduler Status - Automatic update scheduling information
- Manual Updates - Trigger immediate data updates
📊 Data Sources
- IPv4 Data: CAIDA AS-relationships since 1998
- IPv6 Data: CAIDA AS-relationships since 2014
- Update Frequency: Monthly snapshots (1st of each month)
- Processing: k-core decomposition analysis using NetworkX
- API: Production deployment at netcores.fi.uba.ar
🔧 CLI Commands
# Start MCP server (for Claude Desktop)
netcores-mcp
# Interactive Claude Desktop setup
netcores-mcp --setup
# Test API connection
netcores-mcp --test
# Run full test suite
netcores-mcp --test-all
# Show current configuration
netcores-mcp --config
# Show help
netcores-mcp --help
📋 Requirements
- Node.js: 18.0.0 or higher (Download)
- npm: Latest version (comes with Node.js)
- Claude Desktop: Latest version with MCP support
- Network: Internet connection to reach NetCores API
Check Requirements
# Verify you have the right versions
node --version # Should be v18.0.0+
npm --version # Any recent version
which netcores-mcp # Should show path after installation
🔧 Configuration & Setup
Automatic Configuration (Recommended)
# Interactive setup - detects your system automatically
netcores-mcp --setup
This command will:
- ✅ Automatically locate your NetCores MCP installation
- ✅ Verify the installation is working correctly
- ✅ Detect your operating system (macOS/Windows/Linux)
- ✅ Find your Claude Desktop configuration file
- ✅ Configure Claude Desktop with the correct absolute path
- ✅ Show you exactly where everything was installed
Manual Configuration
If automatic setup doesn't work:
1. Find Your Claude Desktop Config File
| OS | Location |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |
2. Add NetCores MCP Configuration
Add the following configuration to your Claude Desktop config file:
{
"mcpServers": {
"netcores": {
"command": "netcores-mcp"
}
}
}
This uses the default NetCores server at https://netcores.fi.uba.ar.
Environment Variables
# Set custom API URL (optional)
export NETCORES_API_URL=https://netcores.fi.uba.ar
# Windows PowerShell:
$env:NETCORES_API_URL="https://netcores.fi.uba.ar"
📖 Usage Examples
Once configured, you can use NetCores tools in Claude Desktop:
Basic Health Check
"Check the health of the NetCores system"
ASN Analysis
"Analyze the k-core trends for Google's ASN 15169 over the past year"
Multiple ASN Comparison
"Compare the network centrality trends between Google (AS15169), Meta (AS32934), and Cloudflare (AS13335)"
Data Exploration
"What IPv4 and IPv6 data is available in NetCores? Show me the latest snapshots."
Network Research
"Find the most central ASNs in the current IPv4 Internet topology based on k-core shell indices"
🐛 Troubleshooting
Installation Issues
| Problem | Solution |
|---|---|
| "npm: command not found" | Install Node.js from nodejs.org |
| "EACCES: permission denied" | Use npm config set prefix ~/.npm-global and update PATH |
| "Cannot find module" | Reinstall: npm uninstall -g netcores-mcp && npm install -g https://github.com/estcarisimo/netcores-mcp.git |
| Package not found after install | Check npm global path: npm root -g |
Claude Desktop Issues
| Problem | Diagnosis | Solution |
|---|---|---|
| Claude doesn't see NetCores tools | Config file issue | Run netcores-mcp --setup again |
| "MCP server disconnected" | Server crash | Check logs, restart Claude Desktop |
| Tools listed but don't work | API connectivity | Test with netcores-mcp --test |
| Setup command hangs | Permission/path issue | Run with sudo or fix npm permissions |
Debug Commands
# Check what's actually installed
npm list -g netcores-mcp
# Find installation path
which netcores-mcp
# Test server directly
node $(npm root -g)/netcores-mcp/src/server.js --version
# Validate Claude Desktop config
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | jq .
# Test API server
curl https://netcores.fi.uba.ar/api/health
Log Files
Check these locations for error logs:
| OS | Log Location |
|---|---|
| macOS | ~/Library/Logs/Claude/ |
| Windows | %LOCALAPPDATA%\Claude\logs\ |
| Linux | ~/.local/share/Claude/logs/ |
For more detailed troubleshooting, see .
📄 License
MIT License - see file for details.
🤝 Contributing
Contributions are welcome! Please see our for details.
📚 Related Projects
- NetCores Web App: netcores.fi.uba.ar
- CAIDA AS-Relationships: CAIDA Datasets
- Model Context Protocol: MCP Specification
🏆 Acknowledgments
- CAIDA for providing AS-relationship datasets
- Anthropic for the Model Context Protocol
- Universidad de Buenos Aires for hosting the NetCores service
NetCores MCP - Bringing Internet topology analysis to conversational AI 🌐✨