Universal Public Data MCP Server

🎯 通用公共数据MCP服务器

A. 完全可用的 模型上下文协议（MCP）服务器提供对6个数据类别中21个强大工具的统一访问。现在 完美工作 使用Cursor IDE和其他MCP客户端！

✅ 当前状态：完全工作

该服务器已经过广泛测试 生产准备就绪 与：

• ✅ 完全符合MCP协议 (2024-11-05)
• ✅ 游标IDE集成 （绿点✅)
• ✅ 快速启动 （约2.5秒，改善75%）
• ✅ 21综合工具 横跨6个类别
• ✅ 稳健的错误处理 优美的后撤
• ✅ Windows 10/11兼容性 使用正确的UTF-8编码

🚀 Cursor IDE快速入门

1.安装

git clone https://github.com/inamdarmihir/universal-public-data-mcp-server.git
cd universal-public-data-mcp-server

# Create virtual environment (recommended)
python -m venv venv
venv\Scripts\activate  # Windows

# Install dependencies
pip install -r requirements.txt

2.配置游标IDE

将此添加到光标MCP设置中：

{
  "mcpServers": {
    "universal-public-data": {
      "command": "python",
      "args": [
        "C:\\path\\to\\your\\universal-public-data-mcp-server\\src\\server.py"
      ],
      "cwd": "C:\\path\\to\\your\\universal-public-data-mcp-server",
      "env": {
        "PYTHONUNBUFFERED": "1",
        "PYTHONPATH": "C:\\path\\to\\your\\universal-public-data-mcp-server"
      }
    }
  }
}

3.预期结果

• 绿点✅ 在游标IDE中
• 访问21个强大的数据工具
• 快速、可靠的性能

🔧 服务器功能

📊 政府数据（3种工具）

• get_census_data -美国人口普查人口数据
• get_economic_indicators -美联储经济数据（FRED）
• search_sec_filings -SEC公司文件搜索

🔬 科学数据（3个工具）

• get_nasa_data -美国国家航空航天局空间和地球科学数据
• search_research_papers -PubMed和ArXiv研究论文
• get_climate_data -NOAA气候和天气数据

💰 财务数据（3个工具）

• get_stock_data -实时股票数据和财务指标
• get_crypto_data -加密货币价格和市场数据
• get_exchange_rates -当前货币汇率

📰 新闻与媒体（3个工具）

• get_breaking_news -来自多个来源的最新突发新闻
• search_news -按主题/关键字搜索新闻文章
• analyze_media_sentiment -新闻情绪分析

🌍 地理与环境（3个工具）

• get_weather_data -当前天气和预报
• get_air_quality -按地点划分的空气质量测量
• get_disaster_alerts -自然灾害警报和警告

💻 技术（3个工具）

• get_github_trends -GitHub存储库趋势
• get_domain_info -WHOIS和域名信息
• analyze_tech_trends -技术采用指标

🖥️ 系统监控（3个工具）

• get_system_status -服务器健康和性能指标
• get_api_metrics -API性能统计
• get_cache_stats -缓存性能和命中率

⚡ 性能特点

🚀 快速启动（提高75%）

• 约2.5秒 启动时间（从10+秒缩短）
• 延迟加载 -适配器仅在首次使用时初始化
• 优化导入 -延迟依赖加载

🧠 智能缓存系统

• 内存缓存 带可配置TTL
• Redis支持 （可选）用于分布式缓存
• 缓存命中率跟踪 用于性能监控

🛡️ 企业级可靠性

• 速率限制 保护
• 断路器 针对API故障
• 优美的倒退 当服务不可用时
• 综合录井 （stderr仅用于MCP兼容性）

🔧 技术实现

已解决的问题✅

1. Redis兼容性 -修复了aioredis Python 3.13的问题
2. 启动性能缓慢 -实现了延迟加载（速度提高了75%）
3. 配置文件错误 -已更正所有文件路径
4. Unicode编码问题 -修复了Windows控制台编码
5. MCP通信问题 -清理JSON-RPC的stdout
6. 日志冲突 -已将所有日志移动到stderr

MCP协议合规性

• ✅ 基于stdio的JSON-RPC 沟通
• ✅ 协议版本2024-11-05 支持
• ✅ 工具列表和执行
• ✅ 正确的错误处理和响应
• ✅ 客户能力谈判

测试结果

🎯 FINAL CURSOR MCP CONNECTION TEST
======================================================================
✅ Initialize successful
✅ Initialized notification sent  
✅ Tools list received: 21 tools available
✅ Tool call successful
🎉 ALL TESTS PASSED!

📂 项目结构

universal-public-data-mcp-server/
├── src/
│   ├── server.py              # Main MCP server (WORKING ✅)
│   ├── adapters/              # Data source adapters
│   │   ├── government.py      # Government APIs
│   │   ├── scientific.py      # Scientific APIs
│   │   ├── financial.py       # Financial APIs
│   │   ├── news.py           # News APIs
│   │   ├── geographic.py      # Geographic APIs
│   │   └── technology.py      # Technology APIs
│   └── core/
│       ├── config.py          # Configuration (FIXED ✅)
│       ├── cache.py          # Caching system
│       ├── rate_limiter.py   # Rate limiting
│       └── monitoring.py     # Performance monitoring
├── cursor_mcp_config.json     # Cursor configuration (READY ✅)
├── requirements.txt           # Dependencies
├── MCP_SERVER_SETUP_FINAL.md  # Comprehensive setup guide
└── tests/                     # Comprehensive test suite

🔍 故障排除

红点❌ 在游标IDE中

1. 检查Python路径：确保 python 命令在终端中工作
2. 验证文件路径：更新中的路径 cursor_mcp_config.json 到您的实际位置
3. 虚拟环境：如果使用一个，则激活，或者使用完整的Python路径
4. 检查日志：查看Cursor的MCP日志以了解特定的错误消息

黄色圆点⚠️ 在游标IDE中

• 服务器正在启动-请稍等绿点✅
• 首次初始化时正常（约2.5秒）

性能优化

# Optional: Add API keys for higher rate limits
export NASA_API_KEY="your_key_here"
export GITHUB_API_KEY="your_key_here"

🚀 高级配置

高性能设置

{
  "cache": {
    "enabled": true,
    "redis_enabled": true,
    "redis_url": "redis://localhost:6379/0",
    "default_ttl": 3600
  },
  "rate_limit": {
    "enabled": true,
    "requests_per_minute": 300,
    "burst_limit": 50
  }
}

发展模式

{
  "server": {
    "debug": true,
    "log_level": "DEBUG"
  },
  "cache": {
    "enabled": false
  },
  "rate_limit": {
    "enabled": false
  }
}

🧪 测试

验证安装

# Test server startup
python src/server.py

# Run comprehensive tests
python final_cursor_test.py

# Test individual components
python test_minimal_mcp.py

预期测试输出

🎯 ✅ MCP SERVER IS READY FOR CURSOR!
You can now use the cursor_mcp_config.json file in Cursor
Expected behavior: Green dot ✅ in Cursor IDE

📊 成功指标

🏆 生产就绪功能

• ✅ 完全符合MCP协议
• ✅ 全面的错误处理
• ✅ 性能优化
• ✅ Windows 10/11兼容性
• ✅ 游标IDE集成
• ✅ 广泛的测试覆盖范围
• ✅ 企业级监控
• ✅ 可扩展体系结构

🤝 贡献

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 进行更改
4. 添加新功能的测试
5. 提交您的更改(git commit -m 'Add amazing feature')
6. 推到分支(git push origin feature/amazing-feature)
7. 打开拉取请求

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🔗 链接

• 仓库:
• 问题: 报告问题
• MCP规范: 官方文件
• 安装指南: MCP_SERVER_SETUP_FINAL.md

______________________________________________________________________

🎯 准备在Cursor IDE中彻底改变您的数据访问！ 🚀

*最后更新：与Cursor IDE完美配合，所有测试通过，生产就绪部署。*