Agentic Ai MCP

🚀 项目设置

本项目主要涉及 UV 安装、虚拟环境创建、数据填充、MCP 客户端配置等一系列设置步骤，帮助你快速搭建项目运行环境。

🚀 快速开始

📦 安装指南

UV 安装和设置

1. 安装 UV
   若要安装 UV，可运行以下命令：

   pip install uv
   

2. 验证安装
   运行以下命令确认 UV 已成功安装：

   uv --version
   

使用 pyproject.toml

1. 创建虚拟环境
   运行以下命令创建虚拟环境：

   python -m venv venv
   

2. 激活虚拟环境

   • 在 Windows 上：

     venv\Scripts\activate
     

   • 在 macOS/Linux 上：

     source venv/bin/activate
     

3. 从 pyproject.toml 安装依赖项
   使用 pip 根据 pyproject.toml 文件中的说明安装依赖项：

   pip install .
   

4. 验证安装
   确保所有依赖项都已正确安装：

   pip list
   

5. 运行测试用例
   使用 pytest 确保所有测试用例通过：

   pytest
   

💻 使用示例

填充金融交易数据

执行以下命令以填充示例金融交易数据：

python util/populate_data.py

🔧 技术细节

配置 MCP 客户端 - Windows 上的Claude

1. 定位样本配置文件
   使用提供的 config/sample_claude_desktop_config.json 文件作为模板。

2. 复制配置文件
   将文件放在以下目录中：

   ~\AppData\Roaming\Claude
   

3. 重命名文件
   将文件重命名为 claude_desktop_config.json。

4. 更新配置详细信息

   • 使用文本编辑器打开 claude_desktop_config.json 文件。
   • 更新 Alpha Vantage API Key 为您自己的密钥。
   • 更新 数据库连接详细信息 为适当的凭据和连接字符串。

🔍 后续操作

重新启动 Claude Desktop

重新启动 Claude Desktop，您可能需要从任务管理器中结束任务。注意，一旦重新启动后：

1. 您应该能够看到工具数量以及锤子图标。
2. 这将开始每个工具的背景 Python 程序。