gurixandClaude
d220c27b67
Add comprehensive proposal for general GraphQL tools in MCP server: - proposal.md: Problem statement and impact analysis - tasks.md: Implementation checklist - specs/mcp-integration/spec.md: 3 new MCP tool requirements - specs/graphql-api/spec.md: GraphQL introspection requirement Proposal introduces get_graphql_schema and execute_graphql_query tools to enable AI agents to discover and interact with the GraphQL API dynamically for complex tasks beyond dedicated member tools. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1.2 KiB
1.2 KiB
Why
The current MCP server provides dedicated tools for member management (list_members, get_member, create_member, update_member). While these work well for basic operations, they are limited for complex tasks that require:
- Flexible querying with custom field selection
- Complex filters or relationships (future)
- Ad-hoc data exploration by AI agents
- Leveraging GraphQL's full introspection capabilities
AI agents connected via the MCP server should be able to discover the GraphQL schema dynamically and construct their own queries for complex tasks.
What Changes
- Add
get_graphql_schematool to expose the complete GraphQL schema via introspection - Add
execute_graphql_querytool to allow AI agents to execute arbitrary GraphQL queries and mutations - Update README.md with documentation for the new tools
- Keep existing dedicated member tools for backward compatibility and simple operations
Impact
- Affected specs:
mcp-integration,graphql-api - Affected code:
src/mcp_server.py,README.md - Breaking changes: None (additive only)
- The dedicated member tools remain available, providing a simpler interface for common operations
- AI agents gain flexibility to handle complex queries without requiring new dedicated tools