langchain_data_agent

MCP数据服务

提供方 eosho · 包名 langchain_data_agent

数据服务 stdio · 本地进程 未标注 社区 / 第三方 Claude DesktopCursorClineClaude Code
查看接入方式

NL2SQL - Ask questions in plain English, get SQL queries and results. Powered by LangGraph.

一句话选型结论

按资料字段整理

langchain_data_agent 属于数据服务类 MCP 服务器,stdio · 本地进程,鉴权方式未标注,可直接接入 Claude Desktop、Cursor、Cline 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式stdio · 本地进程 鉴权未标注 部署方式本地部署
GitHub 星标 228 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

langchain_data_agent a2a a2a-protocol ai-agents azure

支持客户端

适用场景

langchain_data_agenta2aa2a-protocol

安装与配置

stdio · 本地进程 未标注
客户端在本机拉起子进程,数据不出本机
pip install langchain_data_agent

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Cross-platform,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Cursor、Cline,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
langchain_data_agent当前 未标注 stdio · 本地进程 本地部署 有 2026-04-02
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方eosho上游标注的维护方 eosho
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时langchain_data_agent · Cross-platform本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-04-02上游最后核验时间

详细介绍

6.7 KB
来自项目仓库与上游目录的原文,未做删改
+  ╔╦╗╔═╗╔╦╗╔═╗  ╔═╗╔═╗╔═╗╔╗╔╔╦╗
+   ║║╠═╣ ║ ╠═╣  ╠═╣║ ╦║╣ ║║║ ║
+  ═╩╝╩ ╩ ╩ ╩ ╩  ╩ ╩╚═╝╚═╝╝╚╝ ╩

[ Natural Language → SQL Query Agent ]

A natural language to SQL (NL2SQL) platform built on LangGraph and Azure OpenAI. This multi-agent system automatically routes user questions to the appropriate database backend and generates optimized SQL queries and results.

Built on top of LangChain's SQLDatabase with extended support for Azure AD authentication, Cosmos DB, and built-in dialect validation.

Features

  • Multi-Database Support: PostgreSQL, Azure SQL, Azure Synapse, Azure Cosmos DB, Databricks SQL, and Google BigQuery
  • Intent Detection: Automatically routes queries to the correct data agent based on question context
  • Multi-Turn Conversations: Follow-up questions with context awareness (e.g., "What's the average?" after a query)
  • SQL Validation: Safe query execution with sqlglot-based validation across all dialects
  • Data Visualization: Generate charts and graphs from query results using natural language (e.g., "show me a bar chart")
  • Configurable Agents: YAML-based configuration for adding new data sources
  • A2A Protocol: Agent-to-Agent interoperability for integration with other A2A-compliant systems

Architecture

Intent Detection Flow

Routes user questions to the appropriate data agent based on context.

Data Agent Flow

Generates, validates, and executes SQL queries with retry logic.

Documentation

  • Database Setup
  • Configuration
  • Data Visualization
  • A2A Protocol

Quick Start

Prerequisites

  • Python 3.12+
  • uv package manager
  • Azure OpenAI deployment

Installation```bash

git clone https://github.com/eosho/langchain_data_agent
cd langchain_data_agent
uv sync --all-extras
cp .env.example .env

Edit .env with your values


### CLI Usage

The CLI provides commands for querying data agents through natural language.```bash
# Show available commands
data-agent --help

Commands:

Command Description
query Run a single query and exit
chat Start interactive chat mode
configs List available configurations
validate Validate configuration files

Options:

Option Description
-c, --config Configuration to use (default: loads all configs)
-v/-q, --verbose/--quiet Show/hide query state (agent, SQL, message history)
-l, --log-level Logging level (debug, info, warning, error)

Each config file contains multiple specialized data agents. The system automatically routes your question to the appropriate agent.

Config Agents Domain
contoso contoso_sales, contoso_products, contoso_inventory Retail data (Databricks, Cosmos DB, PostgreSQL)
adventure_works contoso_hr, hotel_analytics HR & hotel data (Azure SQL, Synapse)
amex financial_transactions Financial data (BigQuery)

Example Questions by Config:

contoso (default)

contoso_sales (Databricks)
1. How many orders were placed last month?
2. What is the total revenue by region?

contoso_products (Cosmos DB)
1. How many active products are there?
2. Find all products with low inventory
3. What is the most expensive product?

contoso_inventory (PostgreSQL)
1. Which products need to be reordered?
2. What is the total inventory by warehouse?
3. How many shipments are in transit?```bash

Single query (loads all configs by default)

data-agent query "How many shipments are in transit?"

Interactive chat

data-agent chat

Use specific config

data-agent query "How many shipments are in transit?" -c contoso
data-agent chat -c contoso


adventure_works

**contoso_hr** (Azure SQL)
1. How many employees are in each department?
2. What is the average salary by department?
3. Who are the top performers this year?

**hotel_analytics** (Synapse)
1. What is the total revenue by hotel?
2. What is the revenue breakdown by booking channel?
3. What is the average daily rate by room type?```bash
data-agent query "What is the total revenue by hotel?" -c adventure_works
data-agent chat -c adventure_works

amex

financial_transactions (BigQuery)
1. What are the total deposits by customer segment?
2. Show me all high-severity fraud alerts from the past week
3. Who are the top 5 customers by transaction volume?
4. Show me a bar chart of transactions by type```bash
data-agent query "What are the total deposits by customer segment?" -c amex
data-agent chat -c amex
``````bash

List available configs

data-agent configs

Validate configuration files

data-agent validate # Validate all configs
data-agent validate contoso # Validate specific config


### Chainlit Web UI

The platform includes a Chainlit-based web interface for interactive data exploration.```bash
# Start the Chainlit UI
chainlit run src/data_agent/ui/app.py

Available Profiles:

Profile Description
Contoso Retail sales database with products, customers, and orders
Amex Financial transactions and merchant data
Adventure Works Sample database with sales and product information

Environment Variables:

Ensure these are set in your .env file:```bash
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com/
AZURE_OPENAI_API_KEY=your-api-key
AZURE_OPENAI_DEPLOYMENT=gpt-4o


### Programmatic Usage```python
import asyncio
from data_agent import DataAgentFlow

async def main():
    async with DataAgentFlow(
        config_path="data_agent/config/contoso.yaml",
        azure_endpoint="https://your-resource.openai.azure.com/",
        api_key="your-api-key",
        deployment_name="gpt-4o",
    ) as flow:
        result = await flow.query("Show me all warehouses")
        print(result["final_response"])

asyncio.run(main())

Supported Databases

The platform includes built-in configuration for these databases:

Database Datasource Type SQL Dialect
PostgreSQL postgres postgres
Azure SQL azure_sql tsql
Azure Synapse synapse tsql
Azure Cosmos DB cosmos cosmosdb
Databricks SQL databricks databricks
Google BigQuery bigquery bigquery
MySQL mysql mysql
SQLite sqlite sqlite

> Note: Any SQLAlchemy-compatible database can be used via shared_db parameter or connection_string in config. The built-in types provide convenience configuration and AAD authentication support.

Development```bash

Format and lint

uv run pre-commit run --all-files

Run tests

uv run pytest
```

License

MIT License - see LICENSE file for details.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
langchain_data_agent 怎么安装?

在客户端按下面的安装命令接入:pip install langchain_data_agent。对应的包名是 langchain_data_agent。装完在客户端配置里引用同一个包或端点。

langchain_data_agent 怎么在 Claude Desktop、Cursor、Cline 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

langchain_data_agent 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

langchain_data_agent 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

langchain_data_agent 支持哪些客户端?

资料标注支持 Claude Desktop、Cursor、Cline、Claude Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

langchain_data_agent 能提供哪些能力?

资料显示能力标签包括 langchain_data_agent、a2a、a2a-protocol、ai-agents、azure。具体工具清单以官方文档为准。

langchain_data_agent 需要什么运行环境?

运行时为 Cross-platform;属于本地进程,需要在本机装好运行环境。

langchain_data_agent 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-04-02。