Jiso - 模型上下文协议专用数据库助手
Jiso帮助您使用自然语言与数据库进行交互，使您无需编写复杂代码即可轻松查询和管理数据。
特点/功能
- 🔐 安全访问使用 AWS Secrets Manager 管理数据库凭据（不硬编码密码）
- 🛡️ 翻译为中文是“盾牌”。 查询安全性仅允许执行带有内置SQL注入保护的SELECT操作
- 🔌 电源插头/插座 MCP建筑事务所/公司基于模型上下文协议，实现可扩展工具集成
- 📊 表格 数据库工具列出表、描述模式、统计记录数、执行安全查询
- 🎯 目标/靶心 行限制自动限制查询结果以防止资源耗尽
- 🧠 这个表情符号通常代表“大脑”或“思考”，在中文里可以翻译为“脑子”或“思考中”。所以，整个句子可以翻译为“脑子”或“正在思考”。 由人工智能驱动通过Ollama使用Llama 3进行自然语言理解
- 💬 流媒体聊天具备智能查询检测功能的实时对话界面，如ChatGPT/Claude
- 🎯（瞄准目标） 以数据库为中心将非数据库查询重定向以保持专业范围
- 🔍 看起来像是一个放大镜的符号，常用于表示搜索、查看细节或探索等意思，在中文中可以翻译为“🔍（放大镜）”或者根据上下文意译为“查看细节”、“搜索”等。由于这是一个符号，没有直接的中文对应词汇，所以通常根据其功能和用途来翻译。 智能意图检测自动检测并路由数据库查询与通用查询
先决条件
- Python 3.8及以上版本
- Ollama 已安装并在本地运行
- Llama 3 模型可在 Ollama 中使用
ollama pull llama3:latest) - 已配置具有适当权限的AWS CLI
- 在您的环境中可访问的PostgreSQL数据库
- 包含数据库凭据的AWS Secrets Manager密钥
核心功能
交互式聊天界面
主要特点是智能聊天界面（python chat_with_database.py):
- 自然语言处理用通俗易懂的英语提问
- 实时流媒体回复逐字逐句地出现，就像现代的AI助手一样
- 数据库焦点自动将非数据库查询重定向回数据库操作
- 智能检测识别不同类型的数据库查询并进行适当路由
可用的数据库操作
- “Table Discovery”可以翻译为“发现新表格”或“表格探索”。具体翻译取决于上下文和使用场景，但这两个翻译都能传达出“发现或探索新表格”的基本意思“有哪些桌子可用？”或“一共有多少张桌子？”
- 模式分析“给我展示一下web_items的结构”或者“哪个表的列数最多？”
- 记录计数“web_items 中有多少条记录？”
- 数据检索“给我显示web_items中的10条最新数据”或“查找最近的项目”
MCP 服务器工具
- 获取表格列出所有数据库表
- 描述表格获取表结构和列信息
- 获取所有模式（或架构）比较多个表之间的架构
- 计数记录统计特定表中的行数
- 执行选择运行安全的SELECT查询，并自动限制结果数量
安全特性
- ✅ 仅选择查询仅允许使用SELECT语句
- ✅ SQL注入防护使用单词边界关键字检测进行查询验证
- ✅ 行限制自动执行 LIMIT 子句（最多 1000 行）
- ✅ 凭证安全代码或日志中未包含数据库凭据
- ✅ AWS集成利用AWS IAM和Secrets Manager
示例对话
数据库查询（流式响应）
👤 You: What tables are in the database?
🔍 Detected database query: get_tables
⏳ Querying database...
📊 Database query completed! Generating response...
🤖 Assistant: I found 3 tables in your database: web_items, web_raw_content,
and web_translated_content. Each table serves a different purpose for storing
web content and translations.👤 You: List all the table with the most column
🔍 Detected database query: get_all_schemas
⏳ Querying database...
📊 Database query completed! Generating response...
🤖 Assistant: After analyzing all tables, here's the column count comparison:
- web_items: 23 columns (most columns)
- web_raw_content: 8 columns
- web_translated_content: 6 columns
The web_items table has the most columns with 23 total columns.非数据库查询（聚焦重定向）
👤 You: who is barack obama?
🤖 Assistant: Hello! I'm happy to help, but I must politely redirect you.
The question "who is barack obama?" is not related to our PostgreSQL database queries.
Instead, let's explore some exciting database-related questions! Here are a few suggestions:
- What tables are available?
- Show me the structure of [table_name]
- How many records are in [table_name]?
- Show me sample data from [table_name]项目结构
alin/
├── src/
│ ├── __init__.py
│ ├── server.py # Main MCP server implementation
│ ├── database.py # PostgreSQL connection manager
│ ├── security.py # Query validation and security
│ └── config.py # Configuration management
├── main.py # MCP server entry point
├── chat_with_database.py # Interactive chat interface
├── test_server.py # Test suite
├── requirements.txt # Python dependencies
├── .env.example # Environment template
└── README.md # This file