Skip to content

mcp-function#572

Merged
general-kroll-4-life merged 2 commits intomainfrom
feature/mcp-function-basic
Oct 8, 2025
Merged

mcp-function#572
general-kroll-4-life merged 2 commits intomainfrom
feature/mcp-function-basic

Conversation

@general-kroll-4-life
Copy link
Contributor

@general-kroll-4-life general-kroll-4-life commented Oct 8, 2025

Description

NOTE: We acknowledge the contribution of Claude Code to this change set.

Implements Model Context Protocol server to enable LLMs to consume StackQL as a first-class information source.

Key features:

  • Backend interface abstraction for flexible query execution
  • Comprehensive configuration with JSON/YAML support
  • Complete MCP protocol implementation (initialize, resources, tools)
  • Multiple transport support (stdio, TCP, WebSocket)
  • Zero dependencies on StackQL internals
  • Example backend for testing and demonstration

The package provides clean separation of concerns with interfaces that can be implemented for in-memory, TCP, or other communication methods as requested in issue #110.

🤖 Generated with Claude Code


  • Hide all concrete types behind interfaces except config structures
  • Make factory functions return interface types
  • Create hierarchical schema interface instead of flat schema
  • Add nolint comments for driver import
  • Remove unused imports and ensure clean API

🤖 Generated with Claude Code


Summary:

  • Leverage golang mcp SDK.
  • Conform golang versioning.
  • Added stackql_mcp_client to Dockerfile.
  • Agnostic backend for MCP.
  • Added robot test MCP HTTP Server Run List Tools.
  • Added robot test MCP HTTP Server Verify Greeting Tool.
  • Added robot test MCP HTTP Server List Providers Tool.
  • Added robot test MCP HTTP Server List Services Tool.
  • Added robot test MCP HTTP Server List Resources Tool.
  • Added robot test MCP HTTP Server List Methods Tool.
  • Added robot test MCP HTTP Server Query Tool.
  • Doc improvements.

Type of change

  • Bug fix (non-breaking change to fix a bug).
  • Feature (non-breaking change to add functionality).
  • Breaking change.
  • Other (eg: documentation change). Please explain.

Issues referenced.

N/A.

Evidence

  • Added robot test MCP HTTP Server Run List Tools.
  • Added robot test MCP HTTP Server Verify Greeting Tool.
  • Added robot test MCP HTTP Server List Providers Tool.
  • Added robot test MCP HTTP Server List Services Tool.
  • Added robot test MCP HTTP Server List Resources Tool.
  • Added robot test MCP HTTP Server List Methods Tool.
  • Added robot test MCP HTTP Server Query Tool.

Checklist:

  • A full round of testing has been completed, and there are no test failures as a result of these changes.
  • The changes are covered with functional and/or integration robot testing.
  • The changes work on all supported platforms.
  • Unit tests pass locally, as per the developer guide.
  • Robot tests pass locally, as per the developer guide.
  • Linter passes locally, as per the developer guide.

Variations

N/A.

Tech Debt

Technical debt is not worsened in this change.

Summary:

Implements Model Context Protocol server to enable LLMs to consume
StackQL as a first-class information source.

Key features:
- Backend interface abstraction for flexible query execution
- Comprehensive configuration with JSON/YAML support
- Complete MCP protocol implementation (initialize, resources, tools)
- Multiple transport support (stdio, TCP, WebSocket)
- Zero dependencies on StackQL internals
- Example backend for testing and demonstration

The package provides clean separation of concerns with interfaces
that can be implemented for in-memory, TCP, or other communication
methods as requested in issue #110.

🤖 Generated with [Claude Code](https://claude.ai/code)

---

- Hide all concrete types behind interfaces except config structures
- Make factory functions return interface types
- Create hierarchical schema interface instead of flat schema
- Add nolint comments for driver import
- Remove unused imports and ensure clean API

🤖 Generated with [Claude Code](https://claude.ai/code)

---

Summary:

- Leverage golang mcp SDK.
- Conform golang versioning.
- Added `stackql_mcp_client` to Dockerfile.
- Agnostic backend for MCP.
- Added robot test `MCP HTTP Server Run List Tools`.
- Added robot test `MCP HTTP Server Verify Greeting Tool`.
- Added robot test `MCP HTTP Server List Providers Tool`.
- Added robot test `MCP HTTP Server List Services Tool`.
- Added robot test `MCP HTTP Server List Resources Tool`.
- Added robot test `MCP HTTP Server List Methods Tool`.
- Added robot test `MCP HTTP Server Query Tool`.
- Doc improvements.
@general-kroll-4-life general-kroll-4-life merged commit bd1e9ad into main Oct 8, 2025
19 checks passed
@general-kroll-4-life general-kroll-4-life deleted the feature/mcp-function-basic branch October 8, 2025 08:34
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.

1 participant