智能事件搜索服务器

一个由Claude AI驱动的智能事件搜索和分析MCP服务器,提供自然语言事件搜索和数据分析功能。

  • by karishmadaga
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 karishmadaga/events-ai

使用说明

人工智能事件搜索MCP服务器

由Claude AI支持的智能事件搜索和分析MCP(模型上下文协议)服务器。该服务器为事件数据库提供自然语言事件搜索功能和数据分析。

特性

  • 人工智能驱动的搜索:使用自然语言查询查找相关事件
  • 事件分析:获取有关事件数据的见解、统计数据和建议
  • 克劳德集成:由Anthropic的Claude AI提供支持,用于智能理解
  • MCP兼容:与Claude Desktop和其他MCP客户端无缝协作

安装

  1. 克隆存储库:
git clone <repository-url>
cd events-ai
  1. 安装依赖项:
npm install
  1. 设置您的环境:
cp .env.example .env
# Add your Anthropic API key to .env
  1. 构建项目:
npm run build

配置

环境变量

创建一个 .env 使用您的Anthropic API密钥文件:

ANTHROPIC_API_KEY=your_anthropic_api_key_here

从获取API密钥https://console.anthropic.com/

Claude桌面配置

添加到您的Claude Desktop配置文件中:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 窗户: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "events-ai": {
      "command": "node",
      "args": ["/absolute/path/to/events-ai/build/index.js"]
    }
  }
}

用法

可用工具

  1. ai_search_事件:自然语言事件搜索

    • 示例:“查找50美元以下的户外活动”
    • 示例:“以人工智能为重点的技术会议”
  2. ai分析事件:事件数据分析

    • 示例:“最受欢迎的活动类别是什么?”
    • 示例:“按类别显示价格趋势”
  3. get_raw_events_data:访问原始JSON事件数据

查询示例

  • “这个周末给我找些有趣的户外活动”
  • “我正在寻找100美元以下的专业社交活动”
  • “向我展示免费的家庭友好活动”
  • “9月份将举办哪些技术会议?”
  • “分析所有活动的价格分布”
  • “为对技术感兴趣的人推荐活动”

发展

脚本

  • npm run build -编译TypeScript
  • npm start -运行已编译的服务器
  • npm run dev -在监视模式下运行TypeScript

项目结构

events-ai/
├── src/
│   └── index.ts          # Main MCP server implementation
├── data/
│   └── events.json       # Event database
├── build/                # Compiled JavaScript (gitignored)
├── package.json
├── tsconfig.json
└── .env                  # Environment variables (gitignored)

事件数据格式

事件应遵循以下JSON结构:

{
  "events": [
    {
      "id": "unique_id",
      "title": "Event Title",
      "date": "2024-08-17",
      "day": "Sunday",
      "cost": "free",
      "type": "category/type",
      "location": "Location Name",
      "category": "specific/category"
    }
  ]
}

需求

  • Node.js 16+
  • TypeScript 5+
  • 无烟煤API键
  • Claude Desktop(用于MCP集成)

许可证

国际协调委员会

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 如果适用,添加测试
  5. 提交拉取请求

支持

有关问题和疑问,请在GitHub上打开问题。