Skip to content

Conversation

@eosho
Copy link
Owner

@eosho eosho commented Jan 14, 2026

This pull request introduces support for the Model Context Protocol (MCP) for integration with Claude Desktop, VS Code, and other MCP clients, and refactors the agent workflow to add a "general chat" capability. It also improves prompt management by centralizing prompt templates and dialect guidelines, and updates documentation to reflect these changes. The most important changes are grouped below.

MCP Protocol Integration:

  • Added MCP protocol support, including a new CLI entrypoint (data-agent-mcp) and documentation for MCP server usage, options, available tools/resources, and client configuration for Claude Desktop, VS Code, and Cursor. [1] [2] [3] [4]

Agent Workflow Refactor & General Chat:

  • Refactored agent workflow to support a new "general_chat" node, allowing the agent to handle general conversation (greetings, capability questions) alongside intent detection and query routing. This includes routing logic updates and a new node implementation using a dedicated prompt. [1] [2] [3] [4] [5] [6] [7] [8] [9]

Prompt Management Improvements:

  • Centralized prompt templates and dialect guidelines in the new prompts module, with documentation for usage, extension, and configuration overrides. Default prompts for intent detection and general chat are now imported and used in agent logic. [1] [2]

Documentation and Config Updates:

  • Updated documentation to reflect changes in configuration file locations, MCP protocol support, and prompt management. The configuration example now points to the new agents directory. [1] [2]

Dependency and CLI Updates:

  • Added mcp>=1.25.0 to dependencies and registered the MCP server CLI entrypoint in pyproject.toml.

Let me know if you want a deeper dive into any of these changes!

eosho added 5 commits January 14, 2026 17:22
- Updated logging configuration in `logging.py` to improve structured logging.
- Refactored AzureOpenAIProvider in `provider.py` to build kwargs dynamically for better handling of optional parameters.
- Introduced MCP server structure with new modules: `__init__.py`, `context.py`, `resources.py`, `server.py`, and `tools.py` for better organization and modularity.
- Implemented resource registration for listing datasources and schemas in `resources.py`.
- Added context management for MCP server in `context.py` to handle connections and state.
- Created tools for executing queries, listing datasources, and validating SQL in `tools.py`.
- Updated prompt handling by introducing a new `builder.py` for assembling prompts from components.
- Added dialect-specific SQL guidelines in `dialects.py` to assist with query generation based on datasource type.
- Enhanced default prompts in `defaults.py` to provide clearer instructions and context for users.
- Improved response formatting in `response.py` and `data_nodes.py` for better user interaction.
- Updated dependencies in `uv.lock` to include the new MCP package and ensure compatibility.
@eosho eosho changed the title Feature/mcp Release 01-14-2026 Jan 14, 2026
@eosho eosho changed the title Release 01-14-2026 Release 01-25-2026 Jan 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants