Skip to content

Add pgpt-mcp-server: Enhanced PrivateGPT MCP Server with API v1.3 integration#13

Open
elswa-dev wants to merge 5 commits into
Fujitsu-AI:mainfrom
elswa-dev:main
Open

Add pgpt-mcp-server: Enhanced PrivateGPT MCP Server with API v1.3 integration#13
elswa-dev wants to merge 5 commits into
Fujitsu-AI:mainfrom
elswa-dev:main

Conversation

@elswa-dev
Copy link
Copy Markdown
Collaborator

Overview

Adds a comprehensive PrivateGPT MCP Server implementation with full API v1.3 compatibility.

Features

  • 15 Tools: Complete CRUD operations for sources, groups, users, and chat
  • Authentication: Dual proxy + Bearer token system
  • RAG Chat: Group-specific knowledge bases with conversation history
  • TypeScript: Full type safety with comprehensive error handling
  • Universal: Compatible with any MCP client

Key Tools

  • chat, continue_chat, get_chat - Conversation management
  • create_source, edit_source, delete_source, get_source, list_sources - Knowledge management
  • list_groups, create_group, delete_group - Group management
  • create_user, edit_user, delete_user - User management
  • logout - Session management

Files Added

clients/Gradio/mcp_servers/pgpt-mcp-server/
├── package.json, tsconfig.json, README.md
└── src/
    ├── index.ts (main server)
    ├── types/api.ts (interfaces)
    └── services/pgpt-service.ts (API layer)

Testing

✅ All features tested with live PrivateGPT instance
✅ User/source/group CRUD operations
✅ RAG chat with knowledge bases
✅ Authentication and error handling

Version: 1.4.0 | License: MIT | Node.js: 18+

…egration

- Add comprehensive PrivateGPT API v1.3 compatibility
- Implement dual authentication system (proxy + Bearer token)
- Add complete CRUD operations for sources with markdown formatting
- Add user management (create, edit, delete users)
- Add group management (list, create, delete groups)
- Add RAG-enabled chat with group-specific knowledge bases
- Add conversation continuation and chat history
- Version 1.4.0 with comprehensive tool documentation
- Enhance error handling and API response mapping
- Support for any MCP client (not just Claude Desktop)

Tested features:
✅ User creation and editing
✅ Source lifecycle (create, get, edit, delete)
✅ Group listing and source management
✅ RAG chat with knowledge base integration
✅ Authentication and token management
- Complete MCP server implementation with 15 tools
- Dual authentication system (proxy + Bearer token)
- Comprehensive error handling and logging
- Support for all PrivateGPT API v1.3 endpoints
- RAG-enabled chat with group-specific knowledge bases
- Full CRUD operations for sources, groups, and users
- Complete API type definitions with validation functions
- PGPTService class with authentication and error handling
- Modular architecture for maintainability
- Type-safe interfaces for all API operations
- Complete setup and installation instructions
- Detailed tool documentation with TypeScript interfaces
- MCP client configuration examples
- API integration details and security information
- Development guidelines and project structure
- Troubleshooting guide and error handling
- Generic for any MCP client (not just Claude Desktop)
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