refactor(xiyan_mcp_server): 重构项目目录结构并更新依赖

- 将 datasource 目录重命名为 utils
- 更新相关文件的导入路径
- 添加 pandas依赖
- 更新 README 安装说明，明确需要 Python 3.11+

Author: XGenerationLab

README.md

@@ -12,6 +12,8 @@ A Model Context Protocol (MCP) server that enables natural language queries to M
 
 ## Installation
 
+Python 3.11+ is required.
+
 ```bash
 pip install xiyan-mcp-server
 ```

requirements.txt

@@ -2,4 +2,5 @@ mcp
 mysql-connector-python>=9.1.0
 sqlalchemy
 llama_index
-yaml
+yaml
+pandas

src/xiyan_mcp_server/database_env.py

@@ -1,4 +1,4 @@
-from datasource.db_source import HITLSQLDatabase
+from .utils.db_source import HITLSQLDatabase
 
 class DataBaseEnv:
     def __init__(self, database: HITLSQLDatabase):

src/xiyan_mcp_server/server.py

@@ -5,12 +5,12 @@
 from mysql.connector import connect, Error
 from mcp.server import  FastMCP
 from mcp.types import TextContent
-from config.db_config import DBConfig
-from database_env import DataBaseEnv
-from datasource.db_source import HITLSQLDatabase
-from utils.db_util import init_db_conn
-from utils.file_util import extract_sql_from_qwen
-from utils.llm_util import call_dashscope
+from .utils.db_config import DBConfig
+from .database_env import DataBaseEnv
+from .utils.db_source import HITLSQLDatabase
+from .utils.db_util import init_db_conn
+from .utils.file_util import extract_sql_from_qwen
+from .utils.llm_util import call_dashscope
 
 mcp = FastMCP("xiyan")
 

src/xiyan_mcp_server/config/db_config.py renamed to src/xiyan_mcp_server/utils/db_config.py

@@ -1,6 +1,6 @@
 import random
-from utils.file_util import read_json_file, write_json_to_file, save_raw_text
-from utils.db_util import examples_to_str
+from .file_util import read_json_file, write_json_to_file, save_raw_text
+from .db_util import examples_to_str
 from typing import Any, Dict, Iterable, List, Optional, Tuple, Union
 
 

src/xiyan_mcp_server/datasource/db_mschema.py renamed to src/xiyan_mcp_server/utils/db_mschema.py

@@ -4,8 +4,8 @@
 from sqlalchemy import MetaData, Table, select, text
 from sqlalchemy.engine import Engine
 
-from datasource.db_mschema import MSchema
-from utils.db_util import examples_to_str, preprocess_sql_query
+from .db_mschema import MSchema
+from .db_util import examples_to_str, preprocess_sql_query
 
 
 class HITLSQLDatabase(SQLDatabase):

src/xiyan_mcp_server/datasource/db_source.py renamed to src/xiyan_mcp_server/utils/db_source.py

@@ -3,7 +3,7 @@
 import datetime, decimal
 from sqlalchemy import create_engine, MetaData, Table, Column, String, Integer, select, text
 from sqlalchemy.engine import Engine
-from config.db_config import DBConfig
+from .db_config import DBConfig
 
 
 def init_db_conn(db_config: DBConfig) -> Engine: