This is page 2 of 16. Use http://codebase.md/fujitsu-ai/mcp-server-for-mas-developments?page={x} to view the full context.
# Directory Structure
```
├── .gitattributes
├── .gitignore
├── agents
│ ├── __init__.py
│ ├── AgentInterface
│ │ ├── __init__.py
│ │ ├── Python
│ │ │ ├── __init__.py
│ │ │ ├── agent.py
│ │ │ ├── color.py
│ │ │ ├── config.py
│ │ │ ├── language.py
│ │ │ ├── local_file_handler.py
│ │ │ └── network.py
│ │ └── requirements.txt
│ ├── AgentMonitoring
│ │ ├── ChatBot-Agent Dashboard Example - Grafana.json
│ │ ├── images
│ │ │ ├── Grafana.png
│ │ │ └── Prometheus.png
│ │ ├── IoT-Agent Dashboard Example - Grafana.json
│ │ ├── OpenAI compatible API - Agent Dashboard Example - Grafana.json
│ │ ├── prometheus Example.yml
│ │ └── README.md
│ ├── ChatBotAgent
│ │ ├── __init__.py
│ │ ├── config.json.example
│ │ ├── html
│ │ │ ├── favicon.ico
│ │ │ ├── index_de.html
│ │ │ ├── index.html
│ │ │ ├── Logo_light.svg
│ │ │ ├── start_http_server.ps1
│ │ │ └── start_http_server.sh
│ │ ├── Python
│ │ │ ├── __init__.py
│ │ │ └── chatbot_agent.py
│ │ ├── README.md
│ │ └── requirements.txt
│ ├── IoTAgent
│ │ ├── config_example.json
│ │ ├── Python
│ │ │ ├── iot_mqtt_agent.py
│ │ │ └── language.py
│ │ ├── README.md
│ │ └── requirements.txt
│ ├── MCP-Client
│ │ ├── __init__.py
│ │ ├── .env.example
│ │ ├── Python
│ │ │ ├── __init__.py
│ │ │ ├── chat_handler.py
│ │ │ ├── config.py
│ │ │ ├── environment.py
│ │ │ ├── llm_client.py
│ │ │ ├── mcp_client_sse.py
│ │ │ ├── mcp_client.py
│ │ │ ├── messages
│ │ │ │ ├── __init__.py
│ │ │ │ ├── message_types
│ │ │ │ │ ├── __init__.py
│ │ │ │ │ ├── incrementing_id_message.py
│ │ │ │ │ ├── initialize_message.py
│ │ │ │ │ ├── json_rpc_message.py
│ │ │ │ │ ├── ping_message.py
│ │ │ │ │ ├── prompts_messages.py
│ │ │ │ │ ├── prompts_models.py
│ │ │ │ │ ├── resources_messages.py
│ │ │ │ │ └── tools_messages.py
│ │ │ │ ├── send_call_tool.py
│ │ │ │ ├── send_initialize_message.py
│ │ │ │ ├── send_message.py
│ │ │ │ ├── send_ping.py
│ │ │ │ ├── send_prompts.py
│ │ │ │ ├── send_resources.py
│ │ │ │ └── send_tools_list.py
│ │ │ ├── system_prompt_generator.py
│ │ │ ├── tools_handler.py
│ │ │ └── transport
│ │ │ ├── __init__.py
│ │ │ └── stdio
│ │ │ ├── __init__.py
│ │ │ ├── stdio_client.py
│ │ │ ├── stdio_server_parameters.py
│ │ │ └── stdio_server_shutdown.py
│ │ ├── README.md
│ │ ├── requirements.txt
│ │ └── server_config.json
│ ├── OpenAI_Compatible_API_Agent
│ │ ├── __init__.py
│ │ ├── docker-compose.yml
│ │ ├── Dockerfile
│ │ ├── pgpt_openai_api_mcp.json.example
│ │ ├── pgpt_openai_api_proxy.json.example
│ │ ├── Python
│ │ │ ├── __init__.py
│ │ │ ├── client_tests
│ │ │ │ ├── __init__.py
│ │ │ │ ├── openai_test_client_structured.py
│ │ │ │ ├── openai_test_client_tools.py
│ │ │ │ ├── openai_test_client.py
│ │ │ │ ├── vllm_client_multimodal.py
│ │ │ │ ├── vllm_client.py
│ │ │ │ ├── vllm_structured.py
│ │ │ │ └── vllm_structured2.py
│ │ │ ├── generate_api_key.py
│ │ │ ├── open_ai_helper.py
│ │ │ ├── openai_compatible_api.py
│ │ │ ├── openai_mcp_api.py
│ │ │ ├── pgpt_api.py
│ │ │ ├── privategpt_api.py
│ │ │ └── vllmproxy.py
│ │ ├── README.md
│ │ └── requirements.txt
│ └── SourceManagerAgent
│ ├── __init__.py
│ ├── config.json.example
│ └── Python
│ ├── __init__.py
│ ├── file_tools
│ │ └── loader_factory.py
│ ├── file_upload_agent.py
│ └── local_db.py
├── clients
│ ├── __init__.py
│ ├── C# .Net
│ │ ├── 1.0 mcp_login
│ │ │ ├── bin
│ │ │ │ └── Debug
│ │ │ │ └── net9.0
│ │ │ │ ├── mcp_login.deps.json
│ │ │ │ ├── mcp_login.dll
│ │ │ │ ├── mcp_login.exe
│ │ │ │ ├── mcp_login.pdb
│ │ │ │ ├── mcp_login.runtimeconfig.json
│ │ │ │ └── Newtonsoft.Json.dll
│ │ │ ├── mcp_login.csproj
│ │ │ ├── obj
│ │ │ │ ├── Debug
│ │ │ │ │ └── net9.0
│ │ │ │ │ ├── .NETCoreApp,Version=v9.0.AssemblyAttributes.cs
│ │ │ │ │ ├── apphost.exe
│ │ │ │ │ ├── mcp_login.AssemblyInfo.cs
│ │ │ │ │ ├── mcp_login.AssemblyInfoInputs.cache
│ │ │ │ │ ├── mcp_login.assets.cache
│ │ │ │ │ ├── mcp_login.csproj.AssemblyReference.cache
│ │ │ │ │ ├── mcp_login.csproj.CoreCompileInputs.cache
│ │ │ │ │ ├── mcp_login.csproj.FileListAbsolute.txt
│ │ │ │ │ ├── mcp_login.csproj.Up2Date
│ │ │ │ │ ├── mcp_login.dll
│ │ │ │ │ ├── mcp_login.GeneratedMSBuildEditorConfig.editorconfig
│ │ │ │ │ ├── mcp_login.genruntimeconfig.cache
│ │ │ │ │ ├── mcp_login.GlobalUsings.g.cs
│ │ │ │ │ ├── mcp_login.pdb
│ │ │ │ │ ├── ref
│ │ │ │ │ │ └── mcp_login.dll
│ │ │ │ │ └── refint
│ │ │ │ │ └── mcp_login.dll
│ │ │ │ ├── mcp_login.csproj.nuget.dgspec.json
│ │ │ │ ├── mcp_login.csproj.nuget.g.props
│ │ │ │ ├── mcp_login.csproj.nuget.g.targets
│ │ │ │ ├── project.assets.json
│ │ │ │ └── project.nuget.cache
│ │ │ └── Program.cs
│ │ ├── 1.1 mcp_logout
│ │ │ ├── bin
│ │ │ │ └── Debug
│ │ │ │ └── net9.0
│ │ │ │ ├── mcp_logout.deps.json
│ │ │ │ ├── mcp_logout.dll
│ │ │ │ ├── mcp_logout.exe
│ │ │ │ ├── mcp_logout.pdb
│ │ │ │ ├── mcp_logout.runtimeconfig.json
│ │ │ │ └── Newtonsoft.Json.dll
│ │ │ ├── mcp_logout.csproj
│ │ │ ├── obj
│ │ │ │ ├── Debug
│ │ │ │ │ └── net9.0
│ │ │ │ │ ├── .NETCoreApp,Version=v9.0.AssemblyAttributes.cs
│ │ │ │ │ ├── apphost.exe
│ │ │ │ │ ├── mcp_logout.AssemblyInfo.cs
│ │ │ │ │ ├── mcp_logout.AssemblyInfoInputs.cache
│ │ │ │ │ ├── mcp_logout.assets.cache
│ │ │ │ │ ├── mcp_logout.csproj.AssemblyReference.cache
│ │ │ │ │ ├── mcp_logout.csproj.CoreCompileInputs.cache
│ │ │ │ │ ├── mcp_logout.csproj.FileListAbsolute.txt
│ │ │ │ │ ├── mcp_logout.csproj.Up2Date
│ │ │ │ │ ├── mcp_logout.dll
│ │ │ │ │ ├── mcp_logout.GeneratedMSBuildEditorConfig.editorconfig
│ │ │ │ │ ├── mcp_logout.genruntimeconfig.cache
│ │ │ │ │ ├── mcp_logout.GlobalUsings.g.cs
│ │ │ │ │ ├── mcp_logout.pdb
│ │ │ │ │ ├── ref
│ │ │ │ │ │ └── mcp_logout.dll
│ │ │ │ │ └── refint
│ │ │ │ │ └── mcp_logout.dll
│ │ │ │ ├── mcp_logout.csproj.nuget.dgspec.json
│ │ │ │ ├── mcp_logout.csproj.nuget.g.props
│ │ │ │ ├── mcp_logout.csproj.nuget.g.targets
│ │ │ │ ├── project.assets.json
│ │ │ │ └── project.nuget.cache
│ │ │ └── Program.cs
│ │ ├── 2.0 mcp_chat
│ │ │ ├── bin
│ │ │ │ └── Debug
│ │ │ │ └── net9.0
│ │ │ │ ├── mcp_chat.deps.json
│ │ │ │ ├── mcp_chat.dll
│ │ │ │ ├── mcp_chat.exe
│ │ │ │ ├── mcp_chat.pdb
│ │ │ │ ├── mcp_chat.runtimeconfig.json
│ │ │ │ └── Newtonsoft.Json.dll
│ │ │ ├── mcp_chat.csproj
│ │ │ ├── obj
│ │ │ │ ├── Debug
│ │ │ │ │ └── net9.0
│ │ │ │ │ ├── .NETCoreApp,Version=v9.0.AssemblyAttributes.cs
│ │ │ │ │ ├── apphost.exe
│ │ │ │ │ ├── mcp_chat.AssemblyInfo.cs
│ │ │ │ │ ├── mcp_chat.AssemblyInfoInputs.cache
│ │ │ │ │ ├── mcp_chat.assets.cache
│ │ │ │ │ ├── mcp_chat.csproj.AssemblyReference.cache
│ │ │ │ │ ├── mcp_chat.csproj.CoreCompileInputs.cache
│ │ │ │ │ ├── mcp_chat.csproj.FileListAbsolute.txt
│ │ │ │ │ ├── mcp_chat.csproj.Up2Date
│ │ │ │ │ ├── mcp_chat.dll
│ │ │ │ │ ├── mcp_chat.GeneratedMSBuildEditorConfig.editorconfig
│ │ │ │ │ ├── mcp_chat.genruntimeconfig.cache
│ │ │ │ │ ├── mcp_chat.GlobalUsings.g.cs
│ │ │ │ │ ├── mcp_chat.pdb
│ │ │ │ │ ├── ref
│ │ │ │ │ │ └── mcp_chat.dll
│ │ │ │ │ └── refint
│ │ │ │ │ └── mcp_chat.dll
│ │ │ │ ├── mcp_chat.csproj.nuget.dgspec.json
│ │ │ │ ├── mcp_chat.csproj.nuget.g.props
│ │ │ │ ├── mcp_chat.csproj.nuget.g.targets
│ │ │ │ ├── project.assets.json
│ │ │ │ └── project.nuget.cache
│ │ │ └── Program.cs
│ │ ├── 2.1 mcp_continue_chat
│ │ │ ├── bin
│ │ │ │ └── Debug
│ │ │ │ └── net9.0
│ │ │ │ ├── mcp_continue_chat.deps.json
│ │ │ │ ├── mcp_continue_chat.dll
│ │ │ │ ├── mcp_continue_chat.exe
│ │ │ │ ├── mcp_continue_chat.pdb
│ │ │ │ ├── mcp_continue_chat.runtimeconfig.json
│ │ │ │ └── Newtonsoft.Json.dll
│ │ │ ├── mcp_continue_chat.csproj
│ │ │ ├── obj
│ │ │ │ ├── Debug
│ │ │ │ │ └── net9.0
│ │ │ │ │ ├── .NETCoreApp,Version=v9.0.AssemblyAttributes.cs
│ │ │ │ │ ├── apphost.exe
│ │ │ │ │ ├── mcp_cont.EF178231.Up2Date
│ │ │ │ │ ├── mcp_continue_chat.AssemblyInfo.cs
│ │ │ │ │ ├── mcp_continue_chat.AssemblyInfoInputs.cache
│ │ │ │ │ ├── mcp_continue_chat.assets.cache
│ │ │ │ │ ├── mcp_continue_chat.csproj.AssemblyReference.cache
│ │ │ │ │ ├── mcp_continue_chat.csproj.CoreCompileInputs.cache
│ │ │ │ │ ├── mcp_continue_chat.csproj.FileListAbsolute.txt
│ │ │ │ │ ├── mcp_continue_chat.dll
│ │ │ │ │ ├── mcp_continue_chat.GeneratedMSBuildEditorConfig.editorconfig
│ │ │ │ │ ├── mcp_continue_chat.genruntimeconfig.cache
│ │ │ │ │ ├── mcp_continue_chat.GlobalUsings.g.cs
│ │ │ │ │ ├── mcp_continue_chat.pdb
│ │ │ │ │ ├── ref
│ │ │ │ │ │ └── mcp_continue_chat.dll
│ │ │ │ │ └── refint
│ │ │ │ │ └── mcp_continue_chat.dll
│ │ │ │ ├── mcp_continue_chat.csproj.nuget.dgspec.json
│ │ │ │ ├── mcp_continue_chat.csproj.nuget.g.props
│ │ │ │ ├── mcp_continue_chat.csproj.nuget.g.targets
│ │ │ │ ├── project.assets.json
│ │ │ │ └── project.nuget.cache
│ │ │ └── Program.cs
│ │ ├── 2.2 mcp_get_chat_info
│ │ │ ├── bin
│ │ │ │ └── Debug
│ │ │ │ └── net9.0
│ │ │ │ ├── mcp_get_chat_info.deps.json
│ │ │ │ ├── mcp_get_chat_info.dll
│ │ │ │ ├── mcp_get_chat_info.exe
│ │ │ │ ├── mcp_get_chat_info.pdb
│ │ │ │ ├── mcp_get_chat_info.runtimeconfig.json
│ │ │ │ └── Newtonsoft.Json.dll
│ │ │ ├── Dokumente - Verknüpfung.lnk
│ │ │ ├── mcp_get_chat_info.csproj
│ │ │ ├── obj
│ │ │ │ ├── Debug
│ │ │ │ │ └── net9.0
│ │ │ │ │ ├── .NETCoreApp,Version=v9.0.AssemblyAttributes.cs
│ │ │ │ │ ├── apphost.exe
│ │ │ │ │ ├── mcp_get_.DFF47B4E.Up2Date
│ │ │ │ │ ├── mcp_get_chat_info.AssemblyInfo.cs
│ │ │ │ │ ├── mcp_get_chat_info.AssemblyInfoInputs.cache
│ │ │ │ │ ├── mcp_get_chat_info.assets.cache
│ │ │ │ │ ├── mcp_get_chat_info.csproj.AssemblyReference.cache
│ │ │ │ │ ├── mcp_get_chat_info.csproj.CoreCompileInputs.cache
│ │ │ │ │ ├── mcp_get_chat_info.csproj.FileListAbsolute.txt
│ │ │ │ │ ├── mcp_get_chat_info.dll
│ │ │ │ │ ├── mcp_get_chat_info.GeneratedMSBuildEditorConfig.editorconfig
│ │ │ │ │ ├── mcp_get_chat_info.genruntimeconfig.cache
│ │ │ │ │ ├── mcp_get_chat_info.GlobalUsings.g.cs
│ │ │ │ │ ├── mcp_get_chat_info.pdb
│ │ │ │ │ ├── ref
│ │ │ │ │ │ └── mcp_get_chat_info.dll
│ │ │ │ │ └── refint
│ │ │ │ │ └── mcp_get_chat_info.dll
│ │ │ │ ├── mcp_get_chat_info.csproj.nuget.dgspec.json
│ │ │ │ ├── mcp_get_chat_info.csproj.nuget.g.props
│ │ │ │ ├── mcp_get_chat_info.csproj.nuget.g.targets
│ │ │ │ ├── project.assets.json
│ │ │ │ └── project.nuget.cache
│ │ │ └── Program.cs
│ │ ├── 3.0 mcp_create_source
│ │ │ ├── bin
│ │ │ │ └── Debug
│ │ │ │ └── net9.0
│ │ │ │ ├── mcp_create_source.deps.json
│ │ │ │ ├── mcp_create_source.dll
│ │ │ │ ├── mcp_create_source.exe
│ │ │ │ ├── mcp_create_source.pdb
│ │ │ │ ├── mcp_create_source.runtimeconfig.json
│ │ │ │ └── Newtonsoft.Json.dll
│ │ │ ├── mcp_create_source.csproj
│ │ │ ├── obj
│ │ │ │ ├── Debug
│ │ │ │ │ └── net9.0
│ │ │ │ │ ├── .NETCoreApp,Version=v9.0.AssemblyAttributes.cs
│ │ │ │ │ ├── apphost.exe
│ │ │ │ │ ├── mcp_crea.CB4ED912.Up2Date
│ │ │ │ │ ├── mcp_create_source.AssemblyInfo.cs
│ │ │ │ │ ├── mcp_create_source.AssemblyInfoInputs.cache
│ │ │ │ │ ├── mcp_create_source.assets.cache
│ │ │ │ │ ├── mcp_create_source.csproj.AssemblyReference.cache
│ │ │ │ │ ├── mcp_create_source.csproj.CoreCompileInputs.cache
│ │ │ │ │ ├── mcp_create_source.csproj.FileListAbsolute.txt
│ │ │ │ │ ├── mcp_create_source.dll
│ │ │ │ │ ├── mcp_create_source.GeneratedMSBuildEditorConfig.editorconfig
│ │ │ │ │ ├── mcp_create_source.genruntimeconfig.cache
│ │ │ │ │ ├── mcp_create_source.GlobalUsings.g.cs
│ │ │ │ │ ├── mcp_create_source.pdb
│ │ │ │ │ ├── ref
│ │ │ │ │ │ └── mcp_create_source.dll
│ │ │ │ │ └── refint
│ │ │ │ │ └── mcp_create_source.dll
│ │ │ │ ├── mcp_create_source.csproj.nuget.dgspec.json
│ │ │ │ ├── mcp_create_source.csproj.nuget.g.props
│ │ │ │ ├── mcp_create_source.csproj.nuget.g.targets
│ │ │ │ ├── project.assets.json
│ │ │ │ └── project.nuget.cache
│ │ │ └── Program.cs
│ │ ├── 3.1 mcp_get_source
│ │ │ ├── bin
│ │ │ │ └── Debug
│ │ │ │ └── net9.0
│ │ │ │ ├── mcp_get_source.deps.json
│ │ │ │ ├── mcp_get_source.dll
│ │ │ │ ├── mcp_get_source.exe
│ │ │ │ ├── mcp_get_source.pdb
│ │ │ │ ├── mcp_get_source.runtimeconfig.json
│ │ │ │ └── Newtonsoft.Json.dll
│ │ │ ├── mcp_get_source.csproj
│ │ │ ├── obj
│ │ │ │ ├── Debug
│ │ │ │ │ └── net9.0
│ │ │ │ │ ├── .NETCoreApp,Version=v9.0.AssemblyAttributes.cs
│ │ │ │ │ ├── apphost.exe
│ │ │ │ │ ├── mcp_get_.4E61956F.Up2Date
│ │ │ │ │ ├── mcp_get_source.AssemblyInfo.cs
│ │ │ │ │ ├── mcp_get_source.AssemblyInfoInputs.cache
│ │ │ │ │ ├── mcp_get_source.assets.cache
│ │ │ │ │ ├── mcp_get_source.csproj.AssemblyReference.cache
│ │ │ │ │ ├── mcp_get_source.csproj.CoreCompileInputs.cache
│ │ │ │ │ ├── mcp_get_source.csproj.FileListAbsolute.txt
│ │ │ │ │ ├── mcp_get_source.dll
│ │ │ │ │ ├── mcp_get_source.GeneratedMSBuildEditorConfig.editorconfig
│ │ │ │ │ ├── mcp_get_source.genruntimeconfig.cache
│ │ │ │ │ ├── mcp_get_source.GlobalUsings.g.cs
│ │ │ │ │ ├── mcp_get_source.pdb
│ │ │ │ │ ├── ref
│ │ │ │ │ │ └── mcp_get_source.dll
│ │ │ │ │ └── refint
│ │ │ │ │ └── mcp_get_source.dll
│ │ │ │ ├── mcp_get_source.csproj.nuget.dgspec.json
│ │ │ │ ├── mcp_get_source.csproj.nuget.g.props
│ │ │ │ ├── mcp_get_source.csproj.nuget.g.targets
│ │ │ │ ├── project.assets.json
│ │ │ │ └── project.nuget.cache
│ │ │ └── Program.cs
│ │ ├── 3.2 mcp_list_sources
│ │ │ ├── bin
│ │ │ │ └── Debug
│ │ │ │ └── net9.0
│ │ │ │ ├── mcp_list_sources.deps.json
│ │ │ │ ├── mcp_list_sources.dll
│ │ │ │ ├── mcp_list_sources.exe
│ │ │ │ ├── mcp_list_sources.pdb
│ │ │ │ ├── mcp_list_sources.runtimeconfig.json
│ │ │ │ └── Newtonsoft.Json.dll
│ │ │ ├── mcp_list_sources.csproj
│ │ │ ├── obj
│ │ │ │ ├── Debug
│ │ │ │ │ └── net9.0
│ │ │ │ │ ├── .NETCoreApp,Version=v9.0.AssemblyAttributes.cs
│ │ │ │ │ ├── apphost.exe
│ │ │ │ │ ├── mcp_list_sources.AssemblyInfo.cs
│ │ │ │ │ ├── mcp_list_sources.AssemblyInfoInputs.cache
│ │ │ │ │ ├── mcp_list_sources.assets.cache
│ │ │ │ │ ├── mcp_list_sources.csproj.AssemblyReference.cache
│ │ │ │ │ ├── mcp_list_sources.csproj.CoreCompileInputs.cache
│ │ │ │ │ ├── mcp_list_sources.csproj.FileListAbsolute.txt
│ │ │ │ │ ├── mcp_list_sources.dll
│ │ │ │ │ ├── mcp_list_sources.GeneratedMSBuildEditorConfig.editorconfig
│ │ │ │ │ ├── mcp_list_sources.genruntimeconfig.cache
│ │ │ │ │ ├── mcp_list_sources.GlobalUsings.g.cs
│ │ │ │ │ ├── mcp_list_sources.pdb
│ │ │ │ │ ├── mcp_list.A720E197.Up2Date
│ │ │ │ │ ├── ref
│ │ │ │ │ │ └── mcp_list_sources.dll
│ │ │ │ │ └── refint
│ │ │ │ │ └── mcp_list_sources.dll
│ │ │ │ ├── mcp_list_sources.csproj.nuget.dgspec.json
│ │ │ │ ├── mcp_list_sources.csproj.nuget.g.props
│ │ │ │ ├── mcp_list_sources.csproj.nuget.g.targets
│ │ │ │ ├── project.assets.json
│ │ │ │ └── project.nuget.cache
│ │ │ └── Program.cs
│ │ ├── 3.3 mcp_edit_source
│ │ │ ├── bin
│ │ │ │ └── Debug
│ │ │ │ └── net9.0
│ │ │ │ ├── mcp_edit_source.deps.json
│ │ │ │ ├── mcp_edit_source.dll
│ │ │ │ ├── mcp_edit_source.exe
│ │ │ │ ├── mcp_edit_source.pdb
│ │ │ │ ├── mcp_edit_source.runtimeconfig.json
│ │ │ │ └── Newtonsoft.Json.dll
│ │ │ ├── mcp_edit_source.csproj
│ │ │ ├── obj
│ │ │ │ ├── Debug
│ │ │ │ │ └── net9.0
│ │ │ │ │ ├── .NETCoreApp,Version=v9.0.AssemblyAttributes.cs
│ │ │ │ │ ├── apphost.exe
│ │ │ │ │ ├── mcp_edit_source.AssemblyInfo.cs
│ │ │ │ │ ├── mcp_edit_source.AssemblyInfoInputs.cache
│ │ │ │ │ ├── mcp_edit_source.assets.cache
│ │ │ │ │ ├── mcp_edit_source.csproj.AssemblyReference.cache
│ │ │ │ │ ├── mcp_edit_source.csproj.CoreCompileInputs.cache
│ │ │ │ │ ├── mcp_edit_source.csproj.FileListAbsolute.txt
│ │ │ │ │ ├── mcp_edit_source.dll
│ │ │ │ │ ├── mcp_edit_source.GeneratedMSBuildEditorConfig.editorconfig
│ │ │ │ │ ├── mcp_edit_source.genruntimeconfig.cache
│ │ │ │ │ ├── mcp_edit_source.GlobalUsings.g.cs
│ │ │ │ │ ├── mcp_edit_source.pdb
│ │ │ │ │ ├── mcp_edit.7303BE3B.Up2Date
│ │ │ │ │ ├── ref
│ │ │ │ │ │ └── mcp_edit_source.dll
│ │ │ │ │ └── refint
│ │ │ │ │ └── mcp_edit_source.dll
│ │ │ │ ├── mcp_edit_source.csproj.nuget.dgspec.json
│ │ │ │ ├── mcp_edit_source.csproj.nuget.g.props
│ │ │ │ ├── mcp_edit_source.csproj.nuget.g.targets
│ │ │ │ ├── project.assets.json
│ │ │ │ └── project.nuget.cache
│ │ │ └── Program.cs
│ │ ├── 3.4 mcp_delete_source
│ │ │ ├── bin
│ │ │ │ └── Debug
│ │ │ │ └── net9.0
│ │ │ │ ├── mcp_delete_source.deps.json
│ │ │ │ ├── mcp_delete_source.dll
│ │ │ │ ├── mcp_delete_source.exe
│ │ │ │ ├── mcp_delete_source.pdb
│ │ │ │ ├── mcp_delete_source.runtimeconfig.json
│ │ │ │ └── Newtonsoft.Json.dll
│ │ │ ├── mcp_delete_source.csproj
│ │ │ ├── obj
│ │ │ │ ├── Debug
│ │ │ │ │ └── net9.0
│ │ │ │ │ ├── .NETCoreApp,Version=v9.0.AssemblyAttributes.cs
│ │ │ │ │ ├── apphost.exe
│ │ │ │ │ ├── mcp_dele.67DD13F9.Up2Date
│ │ │ │ │ ├── mcp_delete_source.AssemblyInfo.cs
│ │ │ │ │ ├── mcp_delete_source.AssemblyInfoInputs.cache
│ │ │ │ │ ├── mcp_delete_source.assets.cache
│ │ │ │ │ ├── mcp_delete_source.csproj.AssemblyReference.cache
│ │ │ │ │ ├── mcp_delete_source.csproj.CoreCompileInputs.cache
│ │ │ │ │ ├── mcp_delete_source.csproj.FileListAbsolute.txt
│ │ │ │ │ ├── mcp_delete_source.dll
│ │ │ │ │ ├── mcp_delete_source.GeneratedMSBuildEditorConfig.editorconfig
│ │ │ │ │ ├── mcp_delete_source.genruntimeconfig.cache
│ │ │ │ │ ├── mcp_delete_source.GlobalUsings.g.cs
│ │ │ │ │ ├── mcp_delete_source.pdb
│ │ │ │ │ ├── ref
│ │ │ │ │ │ └── mcp_delete_source.dll
│ │ │ │ │ └── refint
│ │ │ │ │ └── mcp_delete_source.dll
│ │ │ │ ├── mcp_delete_source.csproj.nuget.dgspec.json
│ │ │ │ ├── mcp_delete_source.csproj.nuget.g.props
│ │ │ │ ├── mcp_delete_source.csproj.nuget.g.targets
│ │ │ │ ├── project.assets.json
│ │ │ │ └── project.nuget.cache
│ │ │ └── Program.cs
│ │ ├── 4.0 mcp_list_groups
│ │ │ ├── bin
│ │ │ │ └── Debug
│ │ │ │ └── net9.0
│ │ │ │ ├── mcp_list_groups.deps.json
│ │ │ │ ├── mcp_list_groups.dll
│ │ │ │ ├── mcp_list_groups.exe
│ │ │ │ ├── mcp_list_groups.pdb
│ │ │ │ ├── mcp_list_groups.runtimeconfig.json
│ │ │ │ └── Newtonsoft.Json.dll
│ │ │ ├── mcp_list_groups.csproj
│ │ │ ├── obj
│ │ │ │ ├── Debug
│ │ │ │ │ └── net9.0
│ │ │ │ │ ├── .NETCoreApp,Version=v9.0.AssemblyAttributes.cs
│ │ │ │ │ ├── apphost.exe
│ │ │ │ │ ├── mcp_list_groups.AssemblyInfo.cs
│ │ │ │ │ ├── mcp_list_groups.AssemblyInfoInputs.cache
│ │ │ │ │ ├── mcp_list_groups.assets.cache
│ │ │ │ │ ├── mcp_list_groups.csproj.AssemblyReference.cache
│ │ │ │ │ ├── mcp_list_groups.csproj.CoreCompileInputs.cache
│ │ │ │ │ ├── mcp_list_groups.csproj.FileListAbsolute.txt
│ │ │ │ │ ├── mcp_list_groups.dll
│ │ │ │ │ ├── mcp_list_groups.GeneratedMSBuildEditorConfig.editorconfig
│ │ │ │ │ ├── mcp_list_groups.genruntimeconfig.cache
│ │ │ │ │ ├── mcp_list_groups.GlobalUsings.g.cs
│ │ │ │ │ ├── mcp_list_groups.pdb
│ │ │ │ │ ├── mcp_list.EBD5E0D2.Up2Date
│ │ │ │ │ ├── ref
│ │ │ │ │ │ └── mcp_list_groups.dll
│ │ │ │ │ └── refint
│ │ │ │ │ └── mcp_list_groups.dll
│ │ │ │ ├── mcp_list_groups.csproj.nuget.dgspec.json
│ │ │ │ ├── mcp_list_groups.csproj.nuget.g.props
│ │ │ │ ├── mcp_list_groups.csproj.nuget.g.targets
│ │ │ │ ├── project.assets.json
│ │ │ │ └── project.nuget.cache
│ │ │ └── Program.cs
│ │ ├── 4.1 mcp_store_group
│ │ │ ├── bin
│ │ │ │ └── Debug
│ │ │ │ └── net9.0
│ │ │ │ ├── mcp_store_group.deps.json
│ │ │ │ ├── mcp_store_group.dll
│ │ │ │ ├── mcp_store_group.exe
│ │ │ │ ├── mcp_store_group.pdb
│ │ │ │ ├── mcp_store_group.runtimeconfig.json
│ │ │ │ └── Newtonsoft.Json.dll
│ │ │ ├── mcp_store_group.csproj
│ │ │ ├── obj
│ │ │ │ ├── Debug
│ │ │ │ │ └── net9.0
│ │ │ │ │ ├── .NETCoreApp,Version=v9.0.AssemblyAttributes.cs
│ │ │ │ │ ├── apphost.exe
│ │ │ │ │ ├── mcp_stor.AFB4AA35.Up2Date
│ │ │ │ │ ├── mcp_store_group.AssemblyInfo.cs
│ │ │ │ │ ├── mcp_store_group.AssemblyInfoInputs.cache
│ │ │ │ │ ├── mcp_store_group.assets.cache
│ │ │ │ │ ├── mcp_store_group.csproj.AssemblyReference.cache
│ │ │ │ │ ├── mcp_store_group.csproj.CoreCompileInputs.cache
│ │ │ │ │ ├── mcp_store_group.csproj.FileListAbsolute.txt
│ │ │ │ │ ├── mcp_store_group.dll
│ │ │ │ │ ├── mcp_store_group.GeneratedMSBuildEditorConfig.editorconfig
│ │ │ │ │ ├── mcp_store_group.genruntimeconfig.cache
│ │ │ │ │ ├── mcp_store_group.GlobalUsings.g.cs
│ │ │ │ │ ├── mcp_store_group.pdb
│ │ │ │ │ ├── ref
│ │ │ │ │ │ └── mcp_store_group.dll
│ │ │ │ │ └── refint
│ │ │ │ │ └── mcp_store_group.dll
│ │ │ │ ├── mcp_store_group.csproj.nuget.dgspec.json
│ │ │ │ ├── mcp_store_group.csproj.nuget.g.props
│ │ │ │ ├── mcp_store_group.csproj.nuget.g.targets
│ │ │ │ ├── project.assets.json
│ │ │ │ └── project.nuget.cache
│ │ │ └── Program.cs
│ │ ├── 4.2 mcp_delete_group
│ │ │ ├── bin
│ │ │ │ └── Debug
│ │ │ │ └── net9.0
│ │ │ │ ├── mcp_delete_group.deps.json
│ │ │ │ ├── mcp_delete_group.dll
│ │ │ │ ├── mcp_delete_group.exe
│ │ │ │ ├── mcp_delete_group.pdb
│ │ │ │ ├── mcp_delete_group.runtimeconfig.json
│ │ │ │ └── Newtonsoft.Json.dll
│ │ │ ├── mcp_delete_group.csproj
│ │ │ ├── obj
│ │ │ │ ├── Debug
│ │ │ │ │ └── net9.0
│ │ │ │ │ ├── .NETCoreApp,Version=v9.0.AssemblyAttributes.cs
│ │ │ │ │ ├── apphost.exe
│ │ │ │ │ ├── mcp_dele.FE1C6298.Up2Date
│ │ │ │ │ ├── mcp_delete_group.AssemblyInfo.cs
│ │ │ │ │ ├── mcp_delete_group.AssemblyInfoInputs.cache
│ │ │ │ │ ├── mcp_delete_group.assets.cache
│ │ │ │ │ ├── mcp_delete_group.csproj.AssemblyReference.cache
│ │ │ │ │ ├── mcp_delete_group.csproj.CoreCompileInputs.cache
│ │ │ │ │ ├── mcp_delete_group.csproj.FileListAbsolute.txt
│ │ │ │ │ ├── mcp_delete_group.dll
│ │ │ │ │ ├── mcp_delete_group.GeneratedMSBuildEditorConfig.editorconfig
│ │ │ │ │ ├── mcp_delete_group.genruntimeconfig.cache
│ │ │ │ │ ├── mcp_delete_group.GlobalUsings.g.cs
│ │ │ │ │ ├── mcp_delete_group.pdb
│ │ │ │ │ ├── ref
│ │ │ │ │ │ └── mcp_delete_group.dll
│ │ │ │ │ └── refint
│ │ │ │ │ └── mcp_delete_group.dll
│ │ │ │ ├── mcp_delete_group.csproj.nuget.dgspec.json
│ │ │ │ ├── mcp_delete_group.csproj.nuget.g.props
│ │ │ │ ├── mcp_delete_group.csproj.nuget.g.targets
│ │ │ │ ├── project.assets.json
│ │ │ │ └── project.nuget.cache
│ │ │ └── Program.cs
│ │ ├── 5.0 mcp_store_user
│ │ │ ├── bin
│ │ │ │ └── Debug
│ │ │ │ └── net9.0
│ │ │ │ ├── mcp_store_user.deps.json
│ │ │ │ ├── mcp_store_user.dll
│ │ │ │ ├── mcp_store_user.exe
│ │ │ │ ├── mcp_store_user.pdb
│ │ │ │ ├── mcp_store_user.runtimeconfig.json
│ │ │ │ └── Newtonsoft.Json.dll
│ │ │ ├── mcp_store_user.csproj
│ │ │ ├── obj
│ │ │ │ ├── Debug
│ │ │ │ │ └── net9.0
│ │ │ │ │ ├── .NETCoreApp,Version=v9.0.AssemblyAttributes.cs
│ │ │ │ │ ├── apphost.exe
│ │ │ │ │ ├── mcp_stor.6C0F0C8A.Up2Date
│ │ │ │ │ ├── mcp_store_user.AssemblyInfo.cs
│ │ │ │ │ ├── mcp_store_user.AssemblyInfoInputs.cache
│ │ │ │ │ ├── mcp_store_user.assets.cache
│ │ │ │ │ ├── mcp_store_user.csproj.AssemblyReference.cache
│ │ │ │ │ ├── mcp_store_user.csproj.CoreCompileInputs.cache
│ │ │ │ │ ├── mcp_store_user.csproj.FileListAbsolute.txt
│ │ │ │ │ ├── mcp_store_user.dll
│ │ │ │ │ ├── mcp_store_user.GeneratedMSBuildEditorConfig.editorconfig
│ │ │ │ │ ├── mcp_store_user.genruntimeconfig.cache
│ │ │ │ │ ├── mcp_store_user.GlobalUsings.g.cs
│ │ │ │ │ ├── mcp_store_user.pdb
│ │ │ │ │ ├── ref
│ │ │ │ │ │ └── mcp_store_user.dll
│ │ │ │ │ └── refint
│ │ │ │ │ └── mcp_store_user.dll
│ │ │ │ ├── mcp_store_user.csproj.nuget.dgspec.json
│ │ │ │ ├── mcp_store_user.csproj.nuget.g.props
│ │ │ │ ├── mcp_store_user.csproj.nuget.g.targets
│ │ │ │ ├── project.assets.json
│ │ │ │ └── project.nuget.cache
│ │ │ └── Program.cs
│ │ ├── 5.1 mcp_edit_user
│ │ │ ├── bin
│ │ │ │ └── Debug
│ │ │ │ └── net9.0
│ │ │ │ ├── mcp_edit_user.deps.json
│ │ │ │ ├── mcp_edit_user.dll
│ │ │ │ ├── mcp_edit_user.exe
│ │ │ │ ├── mcp_edit_user.pdb
│ │ │ │ ├── mcp_edit_user.runtimeconfig.json
│ │ │ │ └── Newtonsoft.Json.dll
│ │ │ ├── mcp_edit_user.csproj
│ │ │ ├── obj
│ │ │ │ ├── Debug
│ │ │ │ │ └── net9.0
│ │ │ │ │ ├── .NETCoreApp,Version=v9.0.AssemblyAttributes.cs
│ │ │ │ │ ├── apphost.exe
│ │ │ │ │ ├── mcp_edit_user.AssemblyInfo.cs
│ │ │ │ │ ├── mcp_edit_user.AssemblyInfoInputs.cache
│ │ │ │ │ ├── mcp_edit_user.assets.cache
│ │ │ │ │ ├── mcp_edit_user.csproj.AssemblyReference.cache
│ │ │ │ │ ├── mcp_edit_user.csproj.CoreCompileInputs.cache
│ │ │ │ │ ├── mcp_edit_user.csproj.FileListAbsolute.txt
│ │ │ │ │ ├── mcp_edit_user.dll
│ │ │ │ │ ├── mcp_edit_user.GeneratedMSBuildEditorConfig.editorconfig
│ │ │ │ │ ├── mcp_edit_user.genruntimeconfig.cache
│ │ │ │ │ ├── mcp_edit_user.GlobalUsings.g.cs
│ │ │ │ │ ├── mcp_edit_user.pdb
│ │ │ │ │ ├── mcp_edit.94A30270.Up2Date
│ │ │ │ │ ├── ref
│ │ │ │ │ │ └── mcp_edit_user.dll
│ │ │ │ │ └── refint
│ │ │ │ │ └── mcp_edit_user.dll
│ │ │ │ ├── mcp_edit_user.csproj.nuget.dgspec.json
│ │ │ │ ├── mcp_edit_user.csproj.nuget.g.props
│ │ │ │ ├── mcp_edit_user.csproj.nuget.g.targets
│ │ │ │ ├── project.assets.json
│ │ │ │ └── project.nuget.cache
│ │ │ └── Program.cs
│ │ ├── 5.2 mcp_delete_user
│ │ │ ├── bin
│ │ │ │ └── Debug
│ │ │ │ └── net9.0
│ │ │ │ ├── mcp_delete_user.deps.json
│ │ │ │ ├── mcp_delete_user.dll
│ │ │ │ ├── mcp_delete_user.exe
│ │ │ │ ├── mcp_delete_user.pdb
│ │ │ │ ├── mcp_delete_user.runtimeconfig.json
│ │ │ │ └── Newtonsoft.Json.dll
│ │ │ ├── mcp_delete_user.csproj
│ │ │ ├── obj
│ │ │ │ ├── Debug
│ │ │ │ │ └── net9.0
│ │ │ │ │ ├── .NETCoreApp,Version=v9.0.AssemblyAttributes.cs
│ │ │ │ │ ├── apphost.exe
│ │ │ │ │ ├── mcp_dele.CEB7E33D.Up2Date
│ │ │ │ │ ├── mcp_delete_user.AssemblyInfo.cs
│ │ │ │ │ ├── mcp_delete_user.AssemblyInfoInputs.cache
│ │ │ │ │ ├── mcp_delete_user.assets.cache
│ │ │ │ │ ├── mcp_delete_user.csproj.AssemblyReference.cache
│ │ │ │ │ ├── mcp_delete_user.csproj.CoreCompileInputs.cache
│ │ │ │ │ ├── mcp_delete_user.csproj.FileListAbsolute.txt
│ │ │ │ │ ├── mcp_delete_user.dll
│ │ │ │ │ ├── mcp_delete_user.GeneratedMSBuildEditorConfig.editorconfig
│ │ │ │ │ ├── mcp_delete_user.genruntimeconfig.cache
│ │ │ │ │ ├── mcp_delete_user.GlobalUsings.g.cs
│ │ │ │ │ ├── mcp_delete_user.pdb
│ │ │ │ │ ├── ref
│ │ │ │ │ │ └── mcp_delete_user.dll
│ │ │ │ │ └── refint
│ │ │ │ │ └── mcp_delete_user.dll
│ │ │ │ ├── mcp_delete_user.csproj.nuget.dgspec.json
│ │ │ │ ├── mcp_delete_user.csproj.nuget.g.props
│ │ │ │ ├── mcp_delete_user.csproj.nuget.g.targets
│ │ │ │ ├── project.assets.json
│ │ │ │ └── project.nuget.cache
│ │ │ └── Program.cs
│ │ ├── Code Archiv
│ │ │ ├── mcp_chat.cs
│ │ │ ├── mcp_continue_chat.cs
│ │ │ ├── mcp_create_source.cs
│ │ │ ├── mcp_delete_group.cs
│ │ │ ├── mcp_delete_source.cs
│ │ │ ├── mcp_delete_user.cs
│ │ │ ├── mcp_edit_source.cs
│ │ │ ├── mcp_edit_user.cs
│ │ │ ├── mcp_get_chat_info.cs
│ │ │ ├── mcp_get_source.cs
│ │ │ ├── mcp_list_groups.cs
│ │ │ ├── mcp_list_sources.cs
│ │ │ ├── mcp_login.cs
│ │ │ ├── mcp_logout.cs
│ │ │ ├── mcp_store_group.cs
│ │ │ └── mcp_store_user.cs
│ │ └── README.md
│ ├── C++
│ │ ├── .vscode
│ │ │ └── launch.json
│ │ ├── 1.0 mcp_login
│ │ │ ├── MCPLoginClient.cpp
│ │ │ └── Non-TLS version
│ │ │ ├── MCPLoginClient.cpp
│ │ │ └── MCPLoginClient.exe
│ │ ├── 1.1 mcp_logout
│ │ │ ├── MCPLogoutClient.cpp
│ │ │ └── MCPLogoutClient.exe
│ │ ├── 2.0 mcp_chat
│ │ │ ├── MCPChatClient.cpp
│ │ │ └── MCPChatClient.exe
│ │ ├── 2.1 mcp_continue_chat
│ │ │ ├── MCPChatContinuationClient.cpp
│ │ │ └── MCPChatContinuationClient.exe
│ │ ├── 2.2 mcp_get_chat_info
│ │ │ ├── MCPGetChatInfoClient.cpp
│ │ │ └── MCPGetChatInfoClient.exe
│ │ ├── 3.0 mcp_create_source
│ │ │ ├── MCPCreateSourceClient.cpp
│ │ │ └── MCPCreateSourceClient.exe
│ │ ├── 3.1 mcp_get_source
│ │ │ ├── MCPGetSourceClient.cpp
│ │ │ └── MCPGetSourceClient.exe
│ │ ├── 3.2 mcp_list_sources
│ │ │ ├── MCPListSourcesClient.cpp
│ │ │ └── MCPListSourcesClient.exe
│ │ ├── 3.3 mcp_edit_source
│ │ │ ├── MCPEditSourceClient.cpp
│ │ │ └── MCPEditSourceClient.exe
│ │ ├── 3.4 mcp_delete_source
│ │ │ ├── MCPDeleteSourceClient.cpp
│ │ │ └── MCPDeleteSourceClient.exe
│ │ ├── 4.0 mcp_list_groups
│ │ │ ├── MCPListGroupsClient.cpp
│ │ │ └── MCPListGroupsClient.exe
│ │ ├── 4.1 mcp_store_group
│ │ │ ├── MCPStoreGroupClient.cpp
│ │ │ └── MCPStoreGroupClient.exe
│ │ ├── 4.2 mcp_delete_group
│ │ │ ├── MPCDeleteGroupClient.cpp
│ │ │ └── MPCDeleteGroupClient.exe
│ │ ├── 5.0 mcp_store_user
│ │ │ ├── MCPStoreUserClient.cpp
│ │ │ └── MCPStoreUserClient.exe
│ │ ├── 5.1 mcp_edit_user
│ │ │ ├── MCPEditUserClient.cpp
│ │ │ └── MCPEditUserClient.exe
│ │ ├── 5.2 mcp_delete_user
│ │ │ ├── MCPDeleteUserClient.cpp
│ │ │ └── MCPDeleteUserClient.exe
│ │ ├── 9.0 mcp_keygen
│ │ │ ├── MCPKeygenClient.cpp
│ │ │ └── MCPKeygenClient.exe
│ │ └── README.md
│ ├── Go
│ │ ├── 1.0 mcp_login
│ │ │ ├── go.mod
│ │ │ ├── MCPLoginClient.exe
│ │ │ └── MCPLoginClient.go
│ │ ├── 1.1 mcp_logout
│ │ │ ├── MCPLogoutClient.exe
│ │ │ └── MCPLogoutClient.go
│ │ ├── 2.0 mcp_chat
│ │ │ ├── MCPChatClient.exe
│ │ │ └── MCPChatClient.go
│ │ ├── 2.1 mcp_continue_chat
│ │ │ ├── MCPChatContinuationClient.exe
│ │ │ └── MCPChatContinuationClient.go
│ │ ├── 2.2 mcp_get_chat_info
│ │ │ ├── MCPGetChatInfoClient.exe
│ │ │ └── MCPGetChatInfoClient.go
│ │ ├── 3.0 mcp_create_source
│ │ │ ├── MCPCreateSourceClient.exe
│ │ │ └── MCPCreateSourceClient.go
│ │ ├── 3.1 mcp_get_source
│ │ │ ├── MCPGetSourceClient.exe
│ │ │ └── MCPGetSourceClient.go
│ │ ├── 3.2 mcp_list_sources
│ │ │ ├── MCPListSourcesClient.exe
│ │ │ └── MCPListSourcesClient.go
│ │ ├── 3.3 mcp_edit_source
│ │ │ ├── MCPEditSourceClient.exe
│ │ │ └── MCPEditSourceClient.go
│ │ ├── 3.4 mcp_delete_source
│ │ │ ├── MCPDeleteSourceClient.exe
│ │ │ └── MCPDeleteSourceClient.go
│ │ ├── 4.0 mcp_list_groups
│ │ │ ├── MCPListGroupsClient.exe
│ │ │ └── MCPListGroupsClient.go
│ │ ├── 4.1 mcp_store_group
│ │ │ ├── MCPStoreGroupClient.exe
│ │ │ └── MCPStoreGroupClient.go
│ │ ├── 4.2 mcp_delete_group
│ │ │ ├── MCPDeleteGroupClient.exe
│ │ │ └── MCPDeleteGroupClient.go
│ │ ├── 5.0 mcp_store_user
│ │ │ ├── MCPStoreUserClient.exe
│ │ │ └── MCPStoreUserClient.go
│ │ ├── 5.1 mcp_edit_user
│ │ │ ├── MCPEditUserClient.exe
│ │ │ └── MCPEditUserClient.go
│ │ ├── 5.2 mcp_delete_user
│ │ │ ├── MCPDeleteUserClient.exe
│ │ │ └── MCPDeleteUserClient.go
│ │ ├── 9.0 mcp_keygen
│ │ │ ├── MCPKeygenClient.exe
│ │ │ └── MCPKeygenClient.go
│ │ └── README.md
│ ├── Gradio
│ │ ├── Api.py
│ │ ├── config.json.example
│ │ ├── config.py
│ │ ├── favicon.ico
│ │ ├── file_tools
│ │ │ └── loader_factory.py
│ │ ├── language.py
│ │ ├── logos
│ │ │ ├── fsas.png
│ │ │ └── Logo_dark.svg
│ │ ├── main.py
│ │ ├── mcp_client.py
│ │ ├── mcp_servers
│ │ │ ├── arxiv
│ │ │ │ ├── arxiv-stdio.js
│ │ │ │ ├── package.json
│ │ │ │ ├── README.md
│ │ │ │ ├── requirements.txt
│ │ │ │ └── server_config.example.json
│ │ │ ├── demo-mcp-server
│ │ │ │ ├── demo-tools-sse.js
│ │ │ │ ├── demo-tools-stdio.js
│ │ │ │ └── tools
│ │ │ │ ├── assets.js
│ │ │ │ ├── calculator.js
│ │ │ │ └── weather.js
│ │ │ ├── filesystem
│ │ │ │ ├── Dockerfile
│ │ │ │ ├── index.ts
│ │ │ │ ├── package.json
│ │ │ │ ├── README.md
│ │ │ │ ├── test
│ │ │ │ │ └── new.txt
│ │ │ │ └── tsconfig.json
│ │ │ ├── moondream
│ │ │ │ └── server.py
│ │ │ ├── pgpt
│ │ │ │ ├── __init__.py
│ │ │ │ ├── Api.py
│ │ │ │ ├── config.json.example
│ │ │ │ ├── config.py
│ │ │ │ ├── language.py
│ │ │ │ ├── pyproject.toml
│ │ │ │ ├── README.md
│ │ │ │ └── server.py
│ │ │ ├── replicate_flux
│ │ │ │ └── server.py
│ │ │ └── sqlite
│ │ │ ├── .python-version
│ │ │ ├── Dockerfile
│ │ │ ├── pyproject.toml
│ │ │ ├── README.md
│ │ │ └── src
│ │ │ └── mcp_server_sqlite
│ │ │ ├── __init__.py
│ │ │ └── server.py
│ │ ├── messages
│ │ │ ├── __init__.py
│ │ │ ├── message_types
│ │ │ │ ├── __init__.py
│ │ │ │ ├── incrementing_id_message.py
│ │ │ │ ├── initialize_message.py
│ │ │ │ ├── json_rpc_message.py
│ │ │ │ ├── ping_message.py
│ │ │ │ ├── prompts_messages.py
│ │ │ │ ├── prompts_models.py
│ │ │ │ ├── resources_messages.py
│ │ │ │ └── tools_messages.py
│ │ │ ├── send_call_tool.py
│ │ │ ├── send_initialize_message.py
│ │ │ ├── send_message.py
│ │ │ ├── send_ping.py
│ │ │ ├── send_prompts.py
│ │ │ ├── send_resources.py
│ │ │ └── send_tools_list.py
│ │ ├── README.md
│ │ ├── requirements.txt
│ │ ├── server_config.json
│ │ ├── SourceManagement.py
│ │ ├── transport
│ │ │ ├── __init__.py
│ │ │ └── stdio
│ │ │ ├── __init__.py
│ │ │ ├── stdio_client.py
│ │ │ ├── stdio_server_parameters.py
│ │ │ └── stdio_server_shutdown.py
│ │ ├── tsconfig.json
│ │ └── UserManagement.py
│ ├── Java
│ │ ├── 1.0 mcp_login
│ │ │ ├── json-20241224.jar
│ │ │ ├── MCPLoginClient.class
│ │ │ └── MCPLoginClient.java
│ │ ├── 1.1 mcp_logout
│ │ │ ├── json-20241224.jar
│ │ │ ├── MCPLogoutClient.class
│ │ │ └── MCPLogoutClient.java
│ │ ├── 2.0 mcp_chat
│ │ │ ├── json-20241224.jar
│ │ │ ├── MCPChatClient.class
│ │ │ └── MCPChatClient.java
│ │ ├── 2.1 mcp_continue_chat
│ │ │ ├── json-20241224.jar
│ │ │ ├── MCPContinueChatClient.class
│ │ │ └── MCPContinueChatClient.java
│ │ ├── 2.2 mcp_get_chat_info
│ │ │ ├── json-20241224.jar
│ │ │ ├── MCPGetChatInfoClient.class
│ │ │ └── MCPGetChatInfoClient.java
│ │ ├── 3.0 mcp_create_source
│ │ │ ├── json-20241224.jar
│ │ │ ├── MCPCreateSourceClient.class
│ │ │ └── MCPCreateSourceClient.java
│ │ ├── 3.1 mcp_get_source
│ │ │ ├── json-20241224.jar
│ │ │ ├── MCPGetSourceClient.class
│ │ │ └── MCPGetSourceClient.java
│ │ ├── 3.2 mcp_list_sources
│ │ │ ├── json-20241224.jar
│ │ │ ├── MCPListSourcesClient.class
│ │ │ └── MCPListSourcesClient.java
│ │ ├── 3.3 mcp_edit_source
│ │ │ ├── json-20241224.jar
│ │ │ ├── MCPEditSourceClient.class
│ │ │ └── MCPEditSourceClient.java
│ │ ├── 3.4 mcp_delete_source
│ │ │ ├── json-20241224.jar
│ │ │ ├── MCPDeleteSourceClient.class
│ │ │ └── MCPDeleteSourceClient.java
│ │ ├── 4.0 mcp_list_groups
│ │ │ ├── json-20241224.jar
│ │ │ ├── MCPListGroupsClient.class
│ │ │ └── MCPListGroupsClient.java
│ │ ├── 4.1 mcp_store_group
│ │ │ ├── json-20241224.jar
│ │ │ ├── MCPStoreGroupClient.class
│ │ │ └── MCPStoreGroupClient.java
│ │ ├── 4.2 mcp_delete_group
│ │ │ ├── json-20241224.jar
│ │ │ ├── MCPDeleteGroupClient.class
│ │ │ └── MCPDeleteGroupClient.java
│ │ ├── 5.0 mcp_store_user
│ │ │ ├── json-20241224.jar
│ │ │ ├── MCPStoreUserClient.class
│ │ │ └── MCPStoreUserClient.java
│ │ ├── 5.1 mcp_edit_user
│ │ │ ├── json-20241224.jar
│ │ │ ├── MCPEditUserClient.class
│ │ │ └── MCPEditUserClient.java
│ │ ├── 5.2 mcp_delete_user
│ │ │ ├── json-20241224.jar
│ │ │ ├── MCPDeleteUserClient.class
│ │ │ └── MCPDeleteUserClient.java
│ │ └── README.md
│ ├── JavaScript
│ │ ├── 1.0 mcp_login
│ │ │ └── MCPLoginClient.js
│ │ ├── 1.1 mcp_logout
│ │ │ └── MCPLogoutClient.js
│ │ ├── 2.0 mcp_chat
│ │ │ └── MCPChatClient.js
│ │ ├── 2.1 mcp_continue_chat
│ │ │ └── MCPContinueChatClient.js
│ │ ├── 2.2 mcp_get_chat_info
│ │ │ └── MCPGetChatInfoClient.js
│ │ ├── 3.0 mcp_create_source
│ │ │ └── MCPCreateSourceClient.js
│ │ ├── 3.1 mcp_get_source
│ │ │ └── MCPGetSourceClient.js
│ │ ├── 3.2 mcp_list_sources
│ │ │ └── MCPListSourcesClient.js
│ │ ├── 3.3 mcp_edit_source
│ │ │ └── MCPEditSourceClient.js
│ │ ├── 3.4 mcp_delete_source
│ │ │ └── MCPDeleteSourceClient.js
│ │ ├── 4.0 mcp_list_groups
│ │ │ └── MCPListGroupsClient.js
│ │ ├── 4.1 mcp_store_group
│ │ │ └── MCPStoreGroupClient.js
│ │ ├── 4.2 mcp_delete_group
│ │ │ └── MCPDeleteGroupClient.js
│ │ ├── 5.0 mcp_store_user
│ │ │ └── MCPStoreUserClient.js
│ │ ├── 5.1 mcp_edit_user
│ │ │ └── MCPEditUserClient.js
│ │ ├── 5.2 mcp_delete_user
│ │ │ └── MCPDeleteUserClient.js
│ │ ├── 9.0 mcp_keygen
│ │ │ └── MCPKeygenClient.js
│ │ └── README.md
│ ├── PHP
│ │ ├── 1.0 mcp_login
│ │ │ └── MCPLoginClient.php
│ │ ├── 1.1 mcp_logout
│ │ │ └── MCPLogoutClient.php
│ │ ├── 2.0 mcp_chat
│ │ │ └── MCPChatClient.php
│ │ ├── 2.1 mcp_continue_chat
│ │ │ └── MCPContinueChatClient.php
│ │ ├── 2.2 mcp_get_chat_info
│ │ │ └── MCPGetChatInfoClient.php
│ │ ├── 3.0 mcp_create_source
│ │ │ └── MCPCreateSourceClient.php
│ │ ├── 3.1 mcp_get_source
│ │ │ └── MCPGetSourceClient.php
│ │ ├── 3.2 mcp_list_sources
│ │ │ └── MCPListSourcesClient.php
│ │ ├── 3.3 mcp_edit_source
│ │ │ └── MCPEditSourceClient.php
│ │ ├── 3.4 mcp_delete_source
│ │ │ └── MCPDeleteSourceClient.php
│ │ ├── 4.0 mcp_list_groups
│ │ │ └── MCPListGroupsClient.php
│ │ ├── 4.1 mcp_store_group
│ │ │ └── MCPStoreGroupClient.php
│ │ ├── 4.2 mcp_delete_group
│ │ │ └── MCPDeleteGroupClient.php
│ │ ├── 5.0 mcp_store_user
│ │ │ └── MCPStoreUserClient.php
│ │ ├── 5.1 mcp_edit_user
│ │ │ └── MCPEditUserClient.php
│ │ ├── 5.2 mcp_delete_user
│ │ │ └── MCPDeleteUserClient.php
│ │ ├── 9.0 mcp_keygen
│ │ │ └── MCPKeygenClient.php
│ │ └── README.md
│ └── Python
│ ├── __init__.py
│ ├── 1.0 mcp_login
│ │ └── MCPLoginClient.py
│ ├── 1.1 mcp_logout
│ │ └── MCPLogoutClient.py
│ ├── 2.0 mcp_chat
│ │ └── MCPChatClient.py
│ ├── 2.1 mcp_continue_chat
│ │ └── MCPContinueChatClient.py
│ ├── 2.2 mcp_get_chat_info
│ │ └── MCPGetChatInfoClient.py
│ ├── 2.3 mcp_delete_all_chats
│ │ └── MCPDeleteAllChatsClient.py
│ ├── 2.4 mcp_delete_chat
│ │ └── MCPDeleteChatClient.py
│ ├── 3.0 mcp_create_source
│ │ └── MCPCreateSourceClient.py
│ ├── 3.1 mcp_get_source
│ │ └── MCPGetSourceClient.py
│ ├── 3.2 mcp_list_sources
│ │ └── MCPListSourcesClient.py
│ ├── 3.3 mcp_edit_source
│ │ └── MCPEditSourceClient.py
│ ├── 3.4 mcp_delete_source
│ │ └── MCPDeleteSourceClient.py
│ ├── 4.0 mcp_list_groups
│ │ └── MCPListGroupsClient.py
│ ├── 4.1 mcp_store_group
│ │ └── MCPStoreGroupClient.py
│ ├── 4.2 mcp_delete_group
│ │ └── MCPDeleteGroupClient.py
│ ├── 5.0 mcp_store_user
│ │ └── MCPStoreUserClient.py
│ ├── 5.1 mcp_edit_user
│ │ └── MCPEditUserClient.py
│ ├── 5.2 mcp_delete_user
│ │ └── MCPDeleteUserClient.py
│ ├── 9.0 mcp_keygen
│ │ └── MCPKeygenClient.py
│ ├── Gradio
│ │ ├── __init__.py
│ │ └── server_config.json
│ └── README.md
├── examples
│ ├── create_users_from_csv
│ │ ├── config.json.example
│ │ ├── config.py
│ │ ├── create_users_from_csv.py
│ │ └── language.py
│ ├── dynamic_sources
│ │ └── rss_reader
│ │ ├── Api.py
│ │ ├── config.json.example
│ │ ├── config.py
│ │ ├── demo_dynamic_sources.py
│ │ └── rss_parser.py
│ ├── example_users_to_add_no_tz.csv
│ └── sftp_upload_with_id
│ ├── Api.py
│ ├── config_ftp.json.example
│ ├── config.py
│ ├── demo_upload.py
│ ├── language.py
│ └── requirements.txt
├── images
│ ├── alternative mcp client.png
│ ├── favicon
│ │ ├── android-chrome-192x192.png
│ │ ├── android-chrome-512x512.png
│ │ ├── apple-touch-icon.png
│ │ ├── favicon-16x16.png
│ │ ├── favicon-32x32.png
│ │ ├── favicon.ico
│ │ └── site.webmanifest
│ ├── mcp-general-architecture.png
│ ├── privateGPT-MCP.png
│ └── privateGPT.png
├── InstallMPCServer.sh
├── jest.config.js
├── LICENSE
├── package.json
├── pgpt.env.json.example
├── README.md
├── security
│ ├── generate_decrypted_password.js
│ └── generate_encrypted_password.js
├── src
│ ├── helper.js
│ ├── index.js
│ ├── logger.js
│ ├── pgpt-messages.js
│ ├── public
│ │ ├── index.html
│ │ └── pgpt-mcp-logo.png
│ ├── services
│ │ └── pgpt-service.ts
│ └── types
│ └── api.ts
├── start_chatbot_agent.ps1
├── start_chatbot_agent.sh
├── start_iot_agent.ps1
├── start_iot_agent.sh
├── start_openai_compatible_api_agent.ps1
├── start_openai_compatible_api_agent.sh
├── tsconfig.json
├── ver
│ ├── index_np.js
│ └── index_proxy_np.js
└── WORKLOG.md
```
# Files
--------------------------------------------------------------------------------
/clients/Java/README.md:
--------------------------------------------------------------------------------
```markdown
# MCP Client Examples (Java)
This repository contains examples for interacting with the MCP server using **Java**. Each console application demonstrates a specific operation and its corresponding server interaction.
## Main Menu
Choose an operation from the list below. Each example demonstrates a specific server interaction.
### 1. Authentication
[1.1 Login User](#10-mcploginclient)
[1.2 Logout User](#12-mcplogoutclient)
### 2. Chat Operations
[2.1 Start a New Chat](#20-mcpchatclient)
[2.2 Continue a Chat Session](#21-mcpcontinuechatclient)
[2.3 Retrieve Chat Info](#22-mcpgetchatinfoclient)
### 3. Source Management
[3.1 Create a New Source](#30-mcpcreatesourceclient)
[3.2 Retrieve Source Details](#31-mcpgetsourceclient)
[3.3 List All Sources in a Group](#32-mcplistsourcesclient)
[3.4 Edit an Existing Source](#33-mcpeditsourceclient)
[3.5 Delete a Source](#34-mcpdeletesourceclient)
### 4. Group Management
[4.1 List All Groups](#40-mcplistgroupsclient)
[4.2 Create/Update a Group](#41-mcpstoregroupclient)
[4.3 Delete a Group](#42-mcpdeletegroupclient)
### 5. User Management
[5.1 Create/Update a User](#50-mcpstoreuserclient)
[5.2 Edit User Details](#51-mcpedituserclient)
[5.3 Delete a User](#52-mcpdeleteuserclient)
---
### 1.0 MCPLoginClient
- **Purpose**: Handles user authentication by sending login requests to the MCP server.
- **Main Features**:
- Sends a `login` command to the server with user credentials.
- Handles JSON-based requests and parses the server's response.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--email`: User email for authentication.
- `--password`: User password for authentication.
- **Usage Example**:
```bash
java -cp json-20241224.jar MCPLoginClient.java ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--email [email protected] ^
--password secret
```
### 1.2 MCPLogoutClient
- **Purpose**: Logs out an authenticated user by invalidating their session token.
- **Main Features**:
- Sends a `logout` command to the server.
- Invalidates the token provided in the request.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--token`: Authentication token to be invalidated.
- **Usage Example**:
```bash
java -cp json-20241224.jar MCPLogoutClient.java ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken
```
---
### 2.0 MCPChatClient
- **Purpose**: Initiates a new chat session with the MCP server.
- **Main Features**:
- Sends a `chat` command to the server with a question.
- Supports optional parameters for public chats, groups, and language.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--token`: Authentication token.
- `--question`: Initial question for the chat session.
- `--use-public`: Optional flag for public chat.
- `--groups`: Optional group list.
- `--language`: Optional language parameter.
- **Usage Example**:
```bash
java -cp json-20241224.jar MCPChatClient.java ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--question "Hello World" ^
--use-public ^
--groups "devops,hr" ^
--language en
```
### 2.1 MCPContinueChatClient
- **Purpose**: Continues an existing chat session by sending follow-up messages.
- **Main Features**:
- Sends a `continue_chat` command to the server.
- Provides the conversation ID and follow-up message.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--token`: Authentication token.
- `--conversation-id`: ID of the conversation to continue.
- `--message`: Follow-up message.
- **Usage Example**:
```bash
java -cp json-20241224.jar MCPContinueChatClient.java ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--conversation-id 12345 ^
--message "Can you provide an update?"
```
### 2.2 MCPGetChatInfoClient
- **Purpose**: Retrieves metadata and status information about an existing chat session.
- **Main Features**:
- Sends a `get_chat_info` command to the server.
- Extracts and displays information about the chat session.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--token`: Authentication token.
- `--chat-id`: ID of the chat session to retrieve information for.
- **Usage Example**:
```bash
java -cp json-20241224.jar MCPGetChatInfoClient.java ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--chat-id 6789
```
---
### 3.0 MCPCreateSourceClient
- **Purpose**: Creates a new source on the MCP server and associates it with specified groups.
- **Main Features**:
- Sends a `create_source` command with details such as name, content, and associated groups.
- Provides robust error handling for missing arguments and server communication issues.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--token`: Authentication token for the session.
- `--name`: Name of the source to create.
- `--content`: Content of the source in plain text or markdown.
- `--groups`: (Optional) List of groups to associate with the source.
- **Usage Example**:
```bash
java -cp json-20241224.jar MCPCreateSourceClient.java ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--name "Sample Source" ^
--content "This is a test content" ^
--groups devops hr
```
---
### 3.1 MCPGetSourceClient
- **Purpose**: Fetches detailed information about a specific source from the MCP server.
- **Main Features**:
- Sends a `get_source` command to the server with the source ID as a parameter.
- Retrieves and displays the source's metadata and contents.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--token`: Authentication token for the server.
- `--source-id`: Unique ID of the source to retrieve.
- **Usage Example**:
```bash
java -cp json-20241224.jar MCPGetSourceClient.java ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--source-id 12345
```
### 3.2 MCPListSourcesClient
- **Purpose**: Lists all sources belonging to a specified group on the MCP server.
- **Main Features**:
- Sends a `list_sources` command with the group name as a parameter.
- Displays a list of sources available in the specified group.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--token`: Authentication token for the server.
- `--group-name`: Name of the group for which to list sources.
- **Usage Example**:
```bash
java -cp json-20241224.jar MCPListSourcesClient.java ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--group-name devops
```
### 3.3 MCPEditSourceClient
- **Purpose**: Edits the details of an existing source on the MCP server.
- **Main Features**:
- Sends an `edit_source` command with optional updates for the source title, content, and group associations.
- Supports adding or updating multiple groups for the source.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--token`: Authentication token for the server.
- `--source-id`: ID of the source to edit.
- `--title`: (Optional) New title for the source.
- `--content`: (Optional) New content for the source.
- `--groups`: (Optional) List of groups to associate with the source.
- **Usage Example**:
```bash
java -cp json-20241224.jar MCPEditSourceClient.java ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--source-id 12345 ^
--title "Updated Title" ^
--content "Updated content for the source." ^
--groups devops finance
```
### 3.4 MCPDeleteSourceClient
- **Purpose**: Deletes a specific source from the MCP server.
- **Main Features**:
- Sends a `delete_source` command to remove the source identified by its ID.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--token`: Authentication token for the server.
- `--source-id`: ID of the source to delete.
- **Usage Example**:
```bash
java -cp json-20241224.jar MCPDeleteSourceClient.java ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--source-id 12345
```
---
### 4.0 MCPListGroupsClient
- **Purpose**:
Lists all the groups available on the MCP server.
- **Main Features**:
- Sends a `list_groups` command to retrieve the available groups.
- Outputs the groups in JSON format.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--token`: Authentication token for the session.
- **Usage Example**:
```bash
java -cp json-20241224.jar MCPListGroupsClient.java ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken
```
### 4.1 MCPStoreGroupClient
- **Purpose**:
- Creates or updates a group on the MCP server.
- **Main Features**:
- Sends a `store_group` command with the group's name and description.
- Allows creation of new groups or modification of existing ones.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--token`: Authentication token for the session.
- `--group-name`: Name of the group to create or update.
- `--description`: (Optional) Description of the group.
- **Usage Example**:
```bash
java -cp json-20241224.jar MCPStoreGroupClient.java ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--group-name "Team DevOps" ^
--description "Group for development and operations"
```
### 4.2 MCPDeleteGroupClient
- **Purpose**:
- Deletes a specified group from the MCP server.
- **Main Features**:
- Sends a `delete_group` command with the group name.
- Ensures the group is removed from the server.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--token`: Authentication token for the session.
- `--group-name`: Name of the group to delete.
- **Usage Example**:
```bash
java -cp json-20241224.jar MCPDeleteGroupClient.java ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--group-name "Team DevOps"
```
---
### 5.0 MCPStoreUserClient
- **Purpose:** Creates or updates user details on the MCP server.
- **Main Features:**
- Sends a `store_user` command with comprehensive user details.
- Allows specification of default values for language and timezone if not provided.
- **Key Arguments:**
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--token`: Authentication token.
- `--name`: Name of the user.
- `--email`: Email address of the user.
- `--password`: Password for the user account.
- `--language` (Optional): User's preferred language (default: "en").
- `--timezone` (Optional): User's timezone (default: "Europe/Berlin").
- `--roles` (Optional): Roles assigned to the user.
- `--groups` (Optional): Groups the user belongs to.
- `--usePublic` (Optional): Flag to set the user as public.
- `--activateFtp` (Optional): Flag to activate FTP access.
- `--ftpPassword` (Optional): Password for FTP access.
**Usage Example:**
```bash
java -cp json-20241224.jar MCPStoreUserClient.java ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--name John ^
--email [email protected] ^
--password secret ^
--language en ^
--roles admin manager ^
--groups devops finance ^
--usePublic ^
--activateFtp ^
--ftpPassword ftpPass123
```
### 5.1 MCPEditUserClient
- **Purpose:** Modifies the details of an existing user on the MCP server.
- **Main Features:**
- Sends an `edit_user` command with the specified user details.
- Supports conditional sending of fields to avoid unnecessary data transmission.
- **Key Arguments:**
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--token`: Authentication token.
- `--user-id`: ID of the user to modify.
- `--name` (Optional): New name of the user.
- `--email` (Optional): New email for the user.
- `--password` (Optional): New password for the user.
- `--language` (Optional): New language for the user.
- `--timezone` (Optional): New timezone for the user.
- `--roles` (Optional): New roles for the user.
- `--groups` (Optional): New groups for the user.
- `--usePublic` (Optional): Flag to set the user as public.
- `--activateFtp` (Optional): Flag to activate FTP for the user.
- `--ftpPassword` (Optional): New password for FTP access.
- **Usage Example:**
```bash
java -cp json-20241224.jar MCPEditUserClient.java ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--user-id 12345 ^
--name Jane ^
--roles manager devops ^
--groups hr devops
```
### 5.2 MCPDeleteUserClient
- **Purpose:** Deletes a user from the MCP server.
- **Main Features:**
- Sends a `delete_user` command using the user's email as an identifier.
- **Key Arguments:**
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--email`: Email address of the user to delete.
- `--token`: Authentication token.
- **Usage Example:**
```bash
java -cp json-20241224.jar MCPDeleteUserClient.java ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--email [email protected]
```
---
## General Notes
**JSON Communication:**
- Each file constructs and sends JSON payloads specific to its functionality.
- Responses from the server are parsed and displayed in JSON format.
**Socket Communication:**
- The files use Java's Socket class for establishing TCP connections with the MCP server.
**Error Handling:**
- The scripts handle missing or invalid arguments gracefully, printing clear usage instructions where necessary.
**Examples:**
- Replace placeholders (e.g., `<SERVER_IP>`, `<TOKEN>`) with actual values relevant to your environment.
## Prerequisites
Java Development Kit (JDK): Ensure you have JDK installed. The code is compatible with Java 8 and above.
## Dependencies:
- org.json library for handling JSON data.
## Build and Run
Compile: Use the `javac` command to compile the Java files.
```bash
javac -cp json-20241224.jar MCPGetChatInfoClient.java
```
Run: Execute the compiled classes with the appropriate parameters as described above:
Compile: Use the `java` command to run the Java files.
```bash
java -cp json-20241224.jar MCPGetChatInfoClient.java
```
## Error Handling
Both clients include error handling for:
- Missing or invalid parameters.
- Server connection issues.
- Unexpected server responses.
## Future Enhancements
- Add support for SSL/TLS encryption for secure communication.
- Implement a configuration file to simplify the command-line parameters.
- Enhance error reporting with detailed server-side error codes.
## License
This project is licensed under the MIT License - see the LICENSE file for details.
This repository and/or code is provided "as is" without warranty of any kind, and use is at your own risk.
```
--------------------------------------------------------------------------------
/clients/Python/README.md:
--------------------------------------------------------------------------------
```markdown
# MCP Client Examples (Python)
This repository contains examples for interacting with the MCP server using **Python**. Each console application demonstrates a specific operation and its corresponding server interaction.
## Main Menu
Choose an operation from the list below. Each example demonstrates a specific server interaction.
### 1. Authentication
[1.1 Login User](#10-mcploginclient)
[1.2 Logout User](#12-mcplogoutclient)
### 2. Chat Operations
[2.0 Start a New Chat](#20-mcpchatclient)
[2.1 Continue a Chat Session](#21-mcpcontinuechatclient)
[2.2 Retrieve Chat Info](#22-mcpgetchatinfoclient)
[2.3 Delete all Chats](#23-mcpdeleteallchatsclient)
[2.4 Delete Chat](#24-mcpdeletechatclient)
### 3. Source Management
[3.1 Create a New Source](#30-mcpcreatesourceclient)
[3.2 Retrieve Source Details](#31-mcpgetsourceclient)
[3.3 List All Sources in a Group](#32-mcplistsourcesclient)
[3.4 Edit an Existing Source](#33-mcpeditsourceclient)
[3.5 Delete a Source](#34-mcpdeletesourceclient)
### 4. Group Management
[4.1 List All Groups](#40-mcplistgroupsclient)
[4.2 Create/Update a Group](#41-mcpstoregroupclient)
[4.3 Delete a Group](#42-mcpdeletegroupclient)
### 5. User Management
[5.1 Create/Update a User](#50-mcpstoreuserclient)
[5.2 Edit User Details](#51-mcpedituserclient)
[5.3 Delete a User](#52-mcpdeleteuserclient)
---
### 1.0 MCPLoginClient
- **Purpose**: Handles user authentication by sending login requests to the MCP server.
- **Main Features**:
- Sends a `login` command to the server with user credentials.
- Handles JSON-based requests and parses the server's response.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--email`: User email for authentication.
- `--password`: User password for authentication.
- `--use-ssl`: Use SSL/TLS security
- `--accept-self-signed`: Accept self signed certificates
- **Usage Example**:
```bash
python MCPLoginClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--email [email protected] ^
--password secret ^
--use-ssl ^
--accept-self-signed
```
### 1.2 MCPLogoutClient
- **Purpose**: Logs out an authenticated user by invalidating their session token.
- **Main Features**:
- Sends a `logout` command to the server.
- Invalidates the token provided in the request.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--use-ssl`: Use SSL/TLS security
- `--accept-self-signed`: Accept self signed certificates
- `--token`: Authentication token to be invalidated.
- **Usage Example**:
```bash
python MCPLogoutClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--use-ssl ^
--accept-self-signed ^
--token MyToken
```
---
### 2.0 MCPChatClient
- **Purpose**: Initiates a new chat session with the MCP server.
- **Main Features**:
- Sends a `chat` command to the server with a question.
- Supports optional parameters for public chats, groups, and language.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--use-ssl`: Use SSL/TLS security
- `--accept-self-signed`: Accept self signed certificates
- `--token`: Authentication token.
- `--question`: Initial question for the chat session.
- `--use-public`: Optional flag for public chat.
- `--groups`: Optional group list.
- `--language`: Optional language parameter.
- **Usage Example**:
```bash
python MCPChatClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--question "Hello World" ^
--use-public ^
--groups "devops,hr" ^
--use-ssl ^
--accept-self-signed ^
--language en
```
### 2.1 MCPContinueChatClient
- **Purpose**: Continues an existing chat session by sending follow-up messages.
- **Main Features**:
- Sends a `continue_chat` command to the server.
- Provides the conversation ID and follow-up message.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--use-ssl`: Use SSL/TLS security
- `--accept-self-signed`: Accept self signed certificates
- `--token`: Authentication token.
- `--conversation-id`: ID of the conversation to continue.
- `--message`: Follow-up message.
- **Usage Example**:
```bash
python MCPContinueChatClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--conversation-id 12345 ^
--use-ssl ^
--accept-self-signed ^
--message "Can you provide an update?"
```
### 2.2 MCPGetChatInfoClient
- **Purpose**: Retrieves metadata and status information about an existing chat session.
- **Main Features**:
- Sends a `get_chat_info` command to the server.
- Extracts and displays information about the chat session.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--use-ssl`: Use SSL/TLS security
- `--accept-self-signed`: Accept self signed certificates
- `--token`: Authentication token.
- `--chat-id`: ID of the chat session to retrieve information for.
- **Usage Example**:
```bash
python MCPGetChatInfoClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--use-ssl ^
--accept-self-signed ^
--chat-id 6789
```
---
### 2.3 MCPDeleteAllChatsClient
- **Purpose**: Deletes all chat history from the server.
- **Main Features**:
- Sends a `delete_all_chats` command to the MCP server.
- Supports optional SSL/TLS encryption for secure communication.
- Allows accepting self-signed certificates.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--token`: Authentication token.
- `--use-ssl`: Enables SSL/TLS encryption.
- `--accept-self-signed`: Accepts self-signed SSL certificates.
- **Usage Example**:
```bash
python MCPDeleteAllChatsClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--use-ssl ^
--accept-self-signed
```
---
### 2.4 MCPDeleteChatClient
- **Purpose**: Deletes a specific chat from the MCP server.
- **Main Features**:
- Sends a `delete_chat` command to the MCP server.
- Supports optional SSL/TLS encryption for secure communication.
- Allows accepting self-signed certificates.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--token`: Authentication token.
- `--chat-id`: ID of the chat session to be deleted.
- `--use-ssl`: Enables SSL/TLS encryption.
- `--accept-self-signed`: Accepts self-signed SSL certificates.
- **Usage Example**:
```bash
python MCPDeleteChatClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--chat-id 6789 ^
--use-ssl ^
--accept-self-signed
```
---
### 3.0 MCPCreateSourceClient
- **Purpose**: Creates a new source on the MCP server and associates it with specified groups.
- **Main Features**:
- Sends a `create_source` command with details such as name, content, and associated groups.
- Provides robust error handling for missing arguments and server communication issues.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--use-ssl`: Use SSL/TLS security
- `--accept-self-signed`: Accept self signed certificates
- `--token`: Authentication token for the session.
- `--name`: Name of the source to create.
- `--content`: Content of the source in plain text or markdown.
- `--groups`: (Optional) List of groups to associate with the source.
- **Usage Example**:
```bash
python MCPCreateSourceClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--name "Sample Source" ^
--content "This is a test content" ^
--use-ssl ^
--accept-self-signed ^
--groups devops hr
```
---
### 3.1 MCPGetSourceClient
- **Purpose**: Fetches detailed information about a specific source from the MCP server.
- **Main Features**:
- Sends a `get_source` command to the server with the source ID as a parameter.
- Retrieves and displays the source's metadata and contents.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--use-ssl`: Use SSL/TLS security
- `--accept-self-signed`: Accept self signed certificates
- `--token`: Authentication token for the server.
- `--source-id`: Unique ID of the source to retrieve.
- **Usage Example**:
```bash
python MCPGetSourceClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--use-ssl ^
--accept-self-signed ^
--source-id 12345
```
### 3.2 MCPListSourcesClient
- **Purpose**: Lists all sources belonging to a specified group on the MCP server.
- **Main Features**:
- Sends a `list_sources` command with the group name as a parameter.
- Displays a list of sources available in the specified group.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--use-ssl`: Use SSL/TLS security
- `--accept-self-signed`: Accept self signed certificates
- `--token`: Authentication token for the server.
- `--group-name`: Name of the group for which to list sources.
- **Usage Example**:
```bash
python MCPListSourcesClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--use-ssl ^
--accept-self-signed ^
--group-name devops
```
### 3.3 MCPEditSourceClient
- **Purpose**: Edits the details of an existing source on the MCP server.
- **Main Features**:
- Sends an `edit_source` command with optional updates for the source title, content, and group associations.
- Supports adding or updating multiple groups for the source.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--use-ssl`: Use SSL/TLS security
- `--accept-self-signed`: Accept self signed certificates
- `--token`: Authentication token for the server.
- `--source-id`: ID of the source to edit.
- `--title`: (Optional) New title for the source.
- `--content`: (Optional) New content for the source.
- `--groups`: (Optional) List of groups to associate with the source.
- **Usage Example**:
```bash
python MCPEditSourceClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--source-id 12345 ^
--title "Updated Title" ^
--content "Updated content for the source." ^
--use-ssl ^
--accept-self-signed ^
--groups devops finance
```
### 3.4 MCPDeleteSourceClient
- **Purpose**: Deletes a specific source from the MCP server.
- **Main Features**:
- Sends a `delete_source` command to remove the source identified by its ID.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--use-ssl`: Use SSL/TLS security
- `--accept-self-signed`: Accept self signed certificates
- `--token`: Authentication token for the server.
- `--source-id`: ID of the source to delete.
- **Usage Example**:
```bash
python MCPDeleteSourceClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--use-ssl ^
--accept-self-signed ^
--source-id 12345
```
---
### 4.0 MCPListGroupsClient
- **Purpose**:
Lists all the groups available on the MCP server.
- **Main Features**:
- Sends a `list_groups` command to retrieve the available groups.
- Outputs the groups in JSON format.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--use-ssl`: Use SSL/TLS security
- `--accept-self-signed`: Accept self signed certificates
- `--token`: Authentication token for the session.
- **Usage Example**:
```bash
python MCPListGroupsClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--use-ssl ^
--accept-self-signed ^
--token MyToken
```
### 4.1 MCPStoreGroupClient
- **Purpose**:
- Creates or updates a group on the MCP server.
- **Main Features**:
- Sends a `store_group` command with the group's name and description.
- Allows creation of new groups or modification of existing ones.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--use-ssl`: Use SSL/TLS security
- `--accept-self-signed`: Accept self signed certificates
- `--token`: Authentication token for the session.
- `--group-name`: Name of the group to create or update.
- `--description`: (Optional) Description of the group.
- **Usage Example**:
```bash
python MCPStoreGroupClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--group-name "Team DevOps" ^
--use-ssl ^
--accept-self-signed ^
--description "Group for development and operations"
```
### 4.2 MCPDeleteGroupClient
- **Purpose**:
- Deletes a specified group from the MCP server.
- **Main Features**:
- Sends a `delete_group` command with the group name.
- Ensures the group is removed from the server.
- **Key Arguments**:
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--use-ssl`: Use SSL/TLS security
- `--accept-self-signed`: Accept self signed certificates
- `--token`: Authentication token for the session.
- `--group-name`: Name of the group to delete.
- **Usage Example**:
```bash
python MCPDeleteGroupClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--token MyToken ^
--use-ssl ^
--accept-self-signed ^
--group-name "Team DevOps"
```
---
### 5.0 MCPStoreUserClient
- **Purpose:** Creates or updates user details on the MCP server.
- **Main Features:**
- Sends a `store_user` command with comprehensive user details.
- Allows specification of default values for language and timezone if not provided.
- **Key Arguments:**
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--use-ssl`: Use SSL/TLS security
- `--accept-self-signed`: Accept self signed certificates
- `--token`: Authentication token.
- `--name`: Name of the user.
- `--email`: Email address of the user.
- `--password`: Password for the user account.
- `--language` (Optional): User's preferred language (default: "en").
- `--timezone` (Optional): User's timezone (default: "Europe/Berlin").
- `--roles` (Optional): Roles assigned to the user.
- `--groups` (Optional): Groups the user belongs to.
- `--usePublic` (Optional): Flag to set the user as public.
- `--activateFtp` (Optional): Flag to activate FTP access.
- `--ftpPassword` (Optional): Password for FTP access.
**Usage Example:**
```bash
python MCPStoreUserClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--use-ssl ^
--accept-self-signed ^
--token MyToken ^
--name John ^
--email [email protected] ^
--password secret ^
--language en ^
--roles admin manager ^
--groups devops finance ^
--usePublic ^
--activateFtp ^
--ftpPassword ftpPass123
```
### 5.1 MCPEditUserClient
- **Purpose:** Modifies the details of an existing user on the MCP server.
- **Main Features:**
- Sends an `edit_user` command with the specified user details.
- Supports conditional sending of fields to avoid unnecessary data transmission.
- **Key Arguments:**
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--use-ssl`: Use SSL/TLS security
- `--accept-self-signed`: Accept self signed certificates
- `--token`: Authentication token.
- `--user-id`: ID of the user to modify.
- `--name` (Optional): New name of the user.
- `--email` (Optional): New email for the user.
- `--password` (Optional): New password for the user.
- `--language` (Optional): New language for the user.
- `--timezone` (Optional): New timezone for the user.
- `--roles` (Optional): New roles for the user.
- `--groups` (Optional): New groups for the user.
- `--usePublic` (Optional): Flag to set the user as public.
- `--activateFtp` (Optional): Flag to activate FTP for the user.
- `--ftpPassword` (Optional): New password for FTP access.
- **Usage Example:**
```bash
python MCPEditUserClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--use-ssl ^
--accept-self-signed ^
--token MyToken ^
--user-id 12345 ^
--name Jane ^
--roles manager devops ^
--groups hr devops
```
### 5.2 MCPDeleteUserClient
- **Purpose:** Deletes a user from the MCP server.
- **Main Features:**
- Sends a `delete_user` command using the user's email as an identifier.
- **Key Arguments:**
- `--server-ip`: IP address of the MCP server.
- `--server-port`: Port number of the MCP server.
- `--email`: Email address of the user to delete.
- `--use-ssl`: Use SSL/TLS security
- `--accept-self-signed`: Accept self signed certificates
- `--token`: Authentication token.
- **Usage Example:**
```bash
python MCPDeleteUserClient.py ^
--server-ip 127.0.0.1 ^
--server-port 1234 ^
--use-ssl ^
--accept-self-signed ^
--token MyToken ^
--email [email protected]
```
---
## General Notes
**JSON Communication:**
- Each file constructs and sends JSON payloads specific to its functionality.
- Responses from the server are parsed and displayed in JSON format.
**Socket Communication:**
- The files use Python's Socket class for establishing TCP connections with the MCP server.
**Error Handling:**
- The scripts handle missing or invalid arguments gracefully, printing clear usage instructions where necessary.
**Examples:**
- Replace placeholders (e.g., `<SERVER_IP>`, `<TOKEN>`) with actual values relevant to your environment.
## Prerequisites
Python Environment: Make sure you have Python 3 installed on your system. You can check by running:
```bash
python --version
```
## Dependencies:
- No additional external modules are needed.
## Build and Run
Run: Execute the python code (.py) with the appropriate parameters as described above.
## Error Handling
Both clients include error handling for:
- Missing or invalid parameters.
- Server connection issues.
- Unexpected server responses.
## Future Enhancements
- Add support for SSL/TLS encryption for secure communication.
- Implement a configuration file to simplify the command-line parameters.
- Enhance error reporting with detailed server-side error codes.
## License
This project is licensed under the MIT License - see the LICENSE file for details.
This repository and/or code is provided "as is" without warranty of any kind, and use is at your own risk.
```
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
```markdown
## Table of Contents
- [**privateGPT MCP Server**](#privateGPT-mcp-server)
- [**What is MCP?**](#what-is-mcp)
- [Why MCP?](#why-mcp)
- [Why Agents](#why-agents)
- [How it Works](#how-it-works)
- [**Interaction Between Agents, LLMs, and MCP Servers**](#interaction-between-agents-llms-and-mcp-servers)
- [Scenario](#scenario)
1. [User Input](#user-input)
2. [Agent Processing](#agent-processing)
3. [LLM Interaction](#llm-interaction)
4. [Response Processing](#response-processing)
5. [Security and Logging](#security-and-logging)
- [**Advantages of Using Agents in This Context**](#advantages-of-using-agents-in-this-context)
- [Modularity](#modularity)
- [Security](#security)
- [Efficiency](#efficiency)
- [Flexibility](#flexibility)
- [**Overview**](#overview)
- [**Security Features Overview**](#security)
- [1. Transport Layer Security (TLS)](#1-transport-layer-security-(tls))
- [2. Password Encryption](#2-password-encryption)
- [3. Key Management](#3-key-management)
- [4. Decryption on the Server](#4-decryption-on-the-server)
- [5. Authorization Tokens](#5-authorization-tokens)
- [6. Restriction of Key Generation (Keygen)](#6-restriction-of-key-generation-keygen)
- [7. Certificate-Based Access Control (CBAC)](#7-certificate-based-access-control-cbac)
- [8. Secure Configuration](#8-secure-configuration)
- [9. Logging and Monitoring](#9-logging-and-monitoring)
- [Summary](#summary)
- [Encrypted Password Generation Tool](#encrypted-password-generation-tool)
1. [Generate a password for the client and/or the server's Proxy_Config](#generate-encrypted-password)
2. [Check the generated encrypted password](#check-the-generated-encrypted-password)
- [Encrypted Password Decryption Tool](#encrypted-password-decryption-tool)
1. [Check the generated encrypted password](#check-the-generated-encrypted-password)
- [**Feature Overview for privateGPT Server**](#feature-overview-for-privateGPT-server)
- [1. Authentication and Authorization](#1-authentication-and-authorization)
- [2. Chat Management](#2-chat-management)
- [3. Group Management](#3-group-management)
- [4. Source Management](#4-source-management)
- [5. User Management](#5-user-management)
- [6. Configuration Flexibility](#6-configuration-flexibility)
- [7. Error Handling and Logging](#7-error-handling-and-logging)
- [8. Security Features](#8-security-features)
- [Example Use Cases](#example-use-cases)
- [How to Use](#how-to-use)
- [**Installation**](#installation)
- [Prerequisites](#prerequisites)
- [Install Dependencies](#install-dependencies)
- [Build the Project](#build-the-project)
- [**Configuration Description**](#configuration-description)
- [Proxy Configuration](#proxy-configuration)
- [Use Proxy](#use-proxy)
- [Header Encryption](#header-encryption)
- [Access Header](#access-header)
- [Example Configuration](#example-configuration)
- [Notes](#notes)
- [Server Configuration](#server-configuration)
- [Server Port](#server-port)
- [Language](#language)
- [SSL Validation](#ssl-validation)
- [Encryption](#encryption)
- [SSL/TLS](#ssltls)
- [Restrictions](#restrictions)
- [Group Restrictions](#restrictions)
- [Enable OpenAI compatible API](#restrictions)
- [Logging](#logging)
- [Written Logfile](#logging)
- [Log IPs](#logging)
- [Anonymous Mode](#logging)
- [Feature Activation/Deactivation](#feature-activationdeactivation)
- [ENABLE_LOGIN](#feature-activationdeactivation)
- [ENABLE_LOGOUT](#feature-activationdeactivation)
- [ENABLE_CHAT](#feature-activationdeactivation)
- [ENABLE_CONTINUE_CHAT](#feature-activationdeactivation)
- [ENABLE_GET_CHAT_INFO](#feature-activationdeactivation)
- [ENABLE_DELETE_ALL_CHATS](#feature-activationdeactivation)
- [ENABLE_DELETE_CHAT](#feature-activationdeactivation)
- [ENABLE_LIST_GROUPS](#feature-activationdeactivation)
- [ENABLE_STORE_GROUP](#feature-activationdeactivation)
- [ENABLE_DELETE_GROUP](#feature-activationdeactivation)
- [ENABLE_CREATE_SOURCE](#feature-activationdeactivation)
- [ENABLE_EDIT_SOURCE](#feature-activationdeactivation)
- [ENABLE_DELETE_SOURCE](#feature-activationdeactivation)
- [ENABLE_GET_SOURCE](#feature-activationdeactivation)
- [ENABLE_LIST_SOURCES](#feature-activationdeactivation)
- [ENABLE_STORE_USER](#feature-activationdeactivation)
- [ENABLE_EDIT_USER](#feature-activationdeactivation)
- [ENABLE_DELETE_USER](#feature-activationdeactivation)
- [ENABLE_REACTIVATE_USER](#feature-activationdeactivation)
- [Usage](#usage)
- [Available Tools](#available-tools)
- [**Project Structure**](#project-structure)
- [License](#license)
# privateGPT MCP Server
A Model Context Protocol (MCP) server implementation that allows you to use privateGPT as an agent for your preferred MCP client.
This enables seamless integration between privateGPT's powerful capabilities and any MCP-compatible application.
## What is MCP?
MCP is an open protocol that standardizes how applications provide context to LLMs. Think of MCP like a USB-C port for AI applications. Just as USB-C provides a standardized way to connect your devices to various peripherals and accessories, MCP provides a standardized way to connect AI models to different data sources and tools.
### Why MCP?
MCP helps you build agents and complex workflows on top of LLMs. LLMs frequently need to integrate with data and tools, and MCP provides:
- A growing list of pre-built integrations that your LLM can directly plug into
- The flexibility to switch between LLM providers and vendors
- Best practices for securing your data within your infrastructure
### How it Works
At its core, MCP follows a client-server architecture where a host application can connect to multiple servers:
- **MCP Hosts**: Programs like Applications, Claude Desktop, IDEs, or AI tools that want to access data through MCP
- **MCP Clients**: Protocol clients that maintain 1:1 connections with servers
- **MCP Servers**: Lightweight programs that each expose specific capabilities through the standardized Model Context Protocol
- **Local Data Sources**: Your computer's files, databases, and services that MCP servers can securely access
- **Remote Services**: External systems available over the internet (e.g., through APIs) that MCP servers can connect to
## Overview
This server provides a bridge between MCP clients and the privateGPT API, allowing you to:
- Chat with privateGPT using both public and private knowledge bases
- Create and manage knowledge sources
- Organize sources into groups
- Control access through group-based permissions
---
# Why Agents
An **agent** in relation to **LLMs** (Large Language Models) and **MCP servers** is a specialized software component that acts as an intermediary between language models and applications. It handles tasks such as processing requests, interacting with the LLM via MCP, managing workflows, ensuring security and efficiency within the overall system, and much more. By utilizing agents, complex AI-based applications can be designed to be effective, secure, and scalable.
**The code for agents in this repository can be used to implement it into own solutions / applications.**
## Interaction Between Agents, LLMs, and MCP Servers
The interaction of these components enables the development of powerful, scalable, and secure AI applications. Below is a simplified scenario that illustrates this interaction:
1. **User Input:** A user sends a request through a user interface hosted on the MCP server.
2. **Agent Processing:** An agent on the MCP server receives the request, validates it, and prepares it for the LLM.
3. **LLM Interaction:** The agent forwards the request to the LLM, which generates a response.
4. **Response Processing:** The agent receives the response from the LLM, processes it further if necessary (e.g., formatting, integration with other data sources), and sends it back to the user.
5. **Security and Logging:** During this process, the agent monitors interactions, ensures that security policies are adhered to, and logs relevant information for later analysis.
## Advantages of Using Agents in This Context
- **Modularity:** Agents allow for a clear separation of responsibilities, making the system easier to maintain and scale.
- **Security:** Centralized management of access and monitoring of activities help minimize security risks.
- **Efficiency:** Automated agents can perform tasks faster and more consistently than manual processes.
- **Flexibility:** Agents can be easily adapted or extended to support new functions or changes in business requirements.
### Importance of Encrypting Passwords
In any application handling sensitive data, security is paramount. This server manages two critical sets of credentials:
1. **Proxy Headers:** Used by for example HAProxy to authenticate and manage traffic.
2. **LLM Access Passwords:** Used to secure access to the large language models.
Storing these passwords in plaintext poses significant security risks, including unauthorized access and potential data breaches.
To mitigate these risks, it is essential to encrypt these passwords and handle only their ciphertext within the system.
### Benefits of Using Ciphertext Only
- **Enhanced Security:** Even if an attacker gains access to the configuration files or environment variables, encrypted passwords remain unintelligible without the corresponding decryption keys.
- **Compliance:** Encryption helps in adhering to security standards and regulations that mandate the protection of sensitive information.
- **Integrity:** Ensures that passwords cannot be tampered with, maintaining the integrity of the authentication mechanisms.
---
# Security
The following security features are implemented to ensure data protection and secure communication between the client application and server. These features cover encryption, decryption, key management, and transport security.
---
## 1. Transport Layer Security (TLS)
- To secure communication between the client and server, TLS can be activate. All data transmitted between the client and server is encrypted using TLS (minimum version 1.2).
## Why Should TLS Be Enabled Between Client and Server?
### a. **Encryption of Communication**
- TLS (Transport Layer Security) ensures that all data transmitted between the client and server is encrypted. This protects sensitive information such as passwords, credit card details, and personal data from eavesdropping attacks (Man-in-the-Middle attacks).
### b. **Data Integrity**
- TLS guarantees that the transmitted data remains unchanged and unaltered. The integrity check ensures that the received data is exactly as it was sent.
### c. **Authentication**
- TLS enables secure authentication of the server (and optionally the client) through digital certificates. This prevents users from falling victim to phishing attacks on fake websites.
### d. **Protection Against Man-in-the-Middle Attacks**
- TLS encrypts the connection, making it nearly impossible for attackers to intercept or manipulate traffic. Without TLS, attackers could capture and modify data packets.
### e. **Compliance with Security Standards and Regulations**
- Many regulatory requirements (e.g., GDPR, PCI-DSS) mandate secure data transmission. TLS is a fundamental component of these security requirements.
### f. **Prevention of Downgrade and Replay Attacks**
- TLS protects against attacks that attempt to downgrade a connection to an insecure version (downgrade attacks) or replay previously valid requests (replay attacks).
## Conclusion
Enabling TLS between client and server is essential to ensure data privacy, security, and communication integrity. It not only protects sensitive information but also helps meet compliance requirements and increases user trust.
---
## 2. Password Encryption
Passwords can be encrypted using RSA (Rivest–Shamir–Adleman) public-key cryptography. This ensures that sensitive data, such as user passwords, are never transmitted in plaintext.
### Method
- **Public key encryption** with a **2048-bit key length**.
- **Padding**: `RSA_PKCS1_PADDING` to enhance security and prevent known padding attacks.
### Process
1. The server administrator encrypts the client's password using the server's public key (`id_rsa_public.pem`) by executing `node security/generate_encrypted_password.js ~/.ssh/id_rsa_public.pem` and hand out the encrpyted password to the client.
2. Alternatively: The client encrypts the password using the server's public key (`id_rsa_public.pem`) by using the `keygen` - Function. Therefore the function has to be enabled in the server's config (`privateGPT.env.json`). Important: Using this function also means transmitting data via the network. Therefore, make sure that the data traffic is secure and cannot be intercepted.
3. Finally, the encrypted password is sent to the server, where it is decrypted using the server's private key.
### Advantages
- **Asymmetric encryption** ensures that only the server can decrypt the password.
- Even if the communication channel is compromised, encrypted data remains secure.
## 3. Key Management
To secure data communication and encryption processes, the following key management principles are followed:
### Public Key
- Stored securely on the server (`id_rsa.pub`).
- Used only for encryption and does not pose a security risk if exposed.
### PEM Key
- Stored securely on the server (`id_rsa_public.pem`).
- Has to be created by using the public cert (see: [Server Configuration](#server-configuration))
### Private Key
- Stored securely on the server (`id_rsa`).
- Restricted access with appropriate file permissions (`chmod 600`).
- Used exclusively for decryption operations.
### Key Rotation
- Keys can be rotated periodically or upon detection of a security incident. Important: if these are reissued, the clients or AI agents immediately lose access to the MCP server and require a new RSA key (encrypted password)!
- Old keys are securely invalidated.
## 4. Decryption on the Server
Decryption is exclusively performed on the server using the private key:
### Process
1. The server receives the encrypted password from the client.
2. The private key decrypts the password to retrieve the original plaintext.
3. The decrypted password is used internally (e.g., authentication) and never stored in plaintext.
### Secure Handling
- Decrypted passwords exist in memory only for the duration of processing.
- Secure memory management practices ensure sensitive data is cleared immediately after use.
### Certificate Validation
- Certificates are validated on both sides to ensure the authenticity of the server and client.
- Optionally, mutual TLS can be enabled for enhanced security.
## 5. Authorization Tokens
Tokens are used to authenticate requests and ensure only authorized users can access the system:
### Token Management
- Tokens are generated upon successful login.
- They are short-lived and automatically expire after a predefined time.
- Tokens are signed using HMAC or RSA, making them tamper-proof.
## 6. Restriction of Key Generation (Keygen)
To prevent misuse of the system, key generation (`keygen`) is restricted:
### Configuration
- The server has a configuration option (`ALLOW_KEYGEN`) to enable or disable key generation.
- Attempts to call the keygen function when disabled result in an error message.
### Audit Logging
- All keygen operations are logged for auditing and monitoring purposes.
## 7. Certificate-Based Access Control (CBAC)
- As the agent does not require a password when certificate authentication is activated and logs on to the server using a key, it is automatically locked to this server.
If it would want to log in to another MCP privateGPT server, this login attempt is rejected as the key is checked against the server's private certificate.
### Features
- Functions such as `keygen`, `store_user`, and `edit_source` are only accessible to authorized roles.
- Unauthorized access attempts are denied with detailed error messages.
### Configuration
- Enabled or disabled functions can be specified in the server's configuration (`Functions` object).
## 8. Secure Configuration
The server configuration contains several security-related options:
### SSL_VALIDATE
- Validates SSL/TLS certificates to ensure secure communication.
- Can be enabled or disabled based on environment requirements (e.g., testing vs. production).
### PW_ENCRYPTION
- Enables or disables password encryption.
- Ensures compatibility in environments where encryption is not feasible.
## 9. Logging and Monitoring
All security-related events are logged for monitoring and troubleshooting:
### Logged Events
- Failed login attempts.
- Key generation requests.
- Unauthorized access attempts.
- Encryption and decryption errors.
## Summary
The implemented security features ensure:
- **Confidentiality** of sensitive data through encryption and secure transport.
- **Integrity** of operations using robust key management and token validation.
- **Role-based and configurable access control** for system functions.
- **Comprehensive monitoring** for proactive detection and response to security threats.
These measures collectively provide a secure environment for client-server communication and data handling.
# Feature Overview for privateGPT Server
The privateGPT Server offers a robust set of features designed to provide efficient, flexible, and secure communication with the Model Context Protocol (MCP). Below is an overview of the key features and functionalities available in the server.
---
## Key Features
### 1. **Authentication and Authorization**
- **Login Functionality**: Authenticate users with email and password to generate access tokens.
- **Logout Functionality**: Securely invalidate user tokens to end sessions.
---
### 2. **Chat Management**
- **Start a Chat**: Initiate a conversation with the server, optionally using public knowledge bases or specific group contexts.
- **Continue a Chat**: Resume an ongoing conversation by providing the chat ID and a follow-up message.
- **Retrieve Chat Information**: Fetch metadata and messages for a specific chat by its ID.
- **Delete all Chats**: Deletes the previous chat histories of the executing user (chat history).
- **Delete Chat**: Deletes the current chat of the executing user.
---
### 3. **Group Management**
- **List Groups**: View personal and assignable groups available to the user.
- **Create Groups**: Add new groups with names and descriptions for organizational purposes.
- **Delete Groups**: Remove existing groups (if enabled in configuration).
---
### 4. **Source Management**
- **Create Sources**: Add new sources with content and assign them to specific groups.
- **Edit Sources**: Update existing sources with new content or metadata.
- **Delete Sources**: Remove sources that are no longer needed.
- **Retrieve Sources**: Fetch information about a specific source by its ID.
- **List Sources**: View all sources assigned to a specific group.
---
### 5. **User Management**
- **Create Users**: Register new users with customizable roles, groups, and settings.
- **Edit Users**: Update user information, including name, email, password, and roles.
- **Delete Users**: Remove users from the system (if enabled in configuration).
- **Reactivate User**: Reactivate a user who was previously deactivated.
---
### 6. **Configuration Flexibility**
- **Function Activation/Deactivation**: Enable or disable individual server functionalities through the `.env` configuration file.
- **Language Support**: Customize the server's system messages to your preferred language (e.g., English or German).
- **SSL Validation**: Toggle SSL validation for secure connections to the server.
---
### 7. **Error Handling and Logging**
- Detailed error messages and logging for:
- Invalid requests
- Authentication failures
- API communication issues
- Configurable responses when a disabled function is accessed.
---
### 8. **Security Features**
- **Token-Based Authentication**: Ensures secure and controlled access to server features.
- **Restricted Group Access**: Option to limit access to `assignableGroups` for enhanced privacy.
---
### Example Use Cases
1. **Customer Support**: Use chat features to build intelligent conversational agents.
2. **Knowledge Management**: Manage and retrieve structured data with sources and groups.
3. **Multi-User Collaboration**: Create, edit, and assign users to groups for collaborative workflows.
4. **Customizable Functionality**: Activate only the features you need for your application.
---
### How to Use
1. Copy the `privateGPT.env.json.example` file to `privateGPT.env.json` e.g. with `cp .\privateGPT.env.json.example .\privateGPT.env.json`
2. Configure the server by editing the `privateGPT.env.json` file.
3. Start the server using the provided script.
4. Interact with the server via API calls to utilize its features.
Refer to the **API Documentation** for detailed usage instructions and examples for each endpoint.
---
The privateGPT Server is a powerful tool for managing structured communication and data in a customizable environment. Tailor its features to your needs for maximum efficiency and control.
## Installation
1. Clone the repository:
```bash
git clone https://github.com/privateGPT-dev/MCP-Server-for-MAS-Developments.git
cd MCP-Server-for-MAS-Developments
```
**Now you have to choose: Manually or automatic.**
### `Manually step-by-step Installation`
2. Install `npm`, for example:
```bash
sudo apt install npm
```
3. Install Dependencies
```bash
npm install
```
4. Build the project:
```bash
npm run build
```
### `or Automatic Installation`
2. Make `InstallMPCServer.sh` executable (Linux):
```bash
sudo chmod +x InstallMPCServer.sh
```
3. Run the Script and you're done. Watch out for error messages and make sure everything is ok.
```bash
./InstallMPCServer.sh
```
---
## Configuration Description
### Proxy Configuration
This section provides detailed explanations for the `Proxy_Config` settings used in the system.
### `Use Proxy`
If a Proxy is used, you have to define a Header for authentication at the Proxy.
| Key | Description | Example Value |
|-----------------|----------------------------------------------------------|---------------|
| **USE_PROXY** |Determines whether the application should route | `true` |
| |requests through a proxy server. | |
Example configuration of a HAProxy's backend. Only request contaning `1234567890ABCDEFHIJ` in the header will be accepted:
```bash
backend mcpserver.mydomain.com
acl valid_header req.hdr(X-Custom-Header) -m str "1234567890ABCDEFHIJ"
http-request deny unless valid_header
http-request del-header X-Custom-Header
server stable 172.16.123.4:443 ssl verify none
```
---
### `Header Encryption`
| Key | Description | Example Value |
|------------------------|----------------------------------------------------------|---------------|
| **HEADER_ENCRYPTED** |Indicates if the custom proxy access header is encrypted. | `true` |
- `"true"`: The access header is encrypted. Use the encryption tool in the security folder on the server to encrypt the Header.
- `"false"`: The access header is plain text.
---
### `Access Header`
The custom header value used for proxy authentication or access control. If `HEADER_ENCRYPTED` is `"true"`, this value must be decrypted before use.
| Key | Description | Example Value |
|--------------------|------------------------------------------------------|---------------|
| **ACCESS_HEADER** | Used for proxy authentication or access control. | `123abc..` |
## Notes
- Ensure that `ACCESS_HEADER` is properly secured if `HEADER_ENCRYPTED` is set to `"true"`.
- Double-check proxy server settings to avoid connectivity issues.
---
### Server Configuration
For secure certificate authentification, create a `.env` file with your privateGPT credentials, for example privateGPT.env.json
Settings can be adjusted in the `.env` file to customize the server and its functionalities.
Generate the certificates (if you haven't ssh certificates use `ssh-keygen -t rsa`), .pem files are needed:
```bash
ssh-keygen -p -m PEM -f ~/.ssh/id_rsa
ssh-keygen -f ~/.ssh/id_rsa.pub -e -m PEM > ~/.ssh/id_rsa_public.pem
```
After this process, you can create Ciphertext from passwords by using the Encrypted Password Encryption Tool and test the cipher with the Encrypted Password Decryption Tool.
You will find the descriptionof how it works in the `Security` section of this document.
Next, you should provide the SSL/TLS certificates `server.crt` and `server.key` to ensure that communication with clients and agents is encrypted.
If you want to use self-signed certificates, you can generate them by executing f.e. the following command:
```bash
openssl req -x509 -newkey rsa:2048 -nodes -keyout server.key -out server.crt -days 365 -subj "/CN=localhost"
```
Note: Clients and agents can detect that the server uses self-signed certificates, as these are potentially insecure compared to official certificates where the organisation is checked and more. However, clients and agents can accept communication with these certificates with the appropriate parameter (see description of the respective client and agent parameters).
---
Below is a sample `.env` configuration file for the privateGPT server, including descriptions for each setting.
Customize these values to fit your environment and requirements.
---
## `Server Port`
| Key | Description | Example Value |
|----------|------------------------------------------------|---------------|
| **PORT** | The port on which the MCP server runs. | `5000` |
---
## `Language`
The system supports out-of-the-box: `de`, `en`, `pt`, `es`, `nl`, `fr`.
Every Language can be easily added by modifying the `privateGPT-messages.js`. This file should be stored after the modification in `/src` as well as in `/dist`.
| Key | Description | Example Value |
|------------|---------------------------------------------------------------------|---------------|
| **LANGUAGE** | The language for the server's system messages (`en` or `de`). | `"de"` |
---
## `SSL Validation`
| Key | Description | Example Value |
|----------------|-----------------------------------------------------------------------------------------|---------------|
| **SSL_VALIDATE** | Use `"false"` only if the server's certificate cannot be validated by the client. | `"false"` |
---
## `Encryption`
| Key | Description | Example Value |
|-------------------|--------------------------------------------------------------------------------------|----------------------------------|
| **PW_ENCRYPTION** | If set to `"true"` the server only accepts passwords in Ciphertext. | `"false"` |
| **PUBLIC_KEY** | Specifies the file system path to the server's public PEM file used for RSA. | `"~/.ssh/id_rsa_public.pem"` |
| **PRIVATE_KEY** | Specifies the file system path to the server's private key file used for RSA. | `"~/.ssh/id_rsa_public.pem"` |
---
## `SSL/TLS`
| Key | Description | Example Value |
|-------------------|-------------------------------------------------------------------------------------------------|----------------------------------|
| **ENABLE_TLS** | If set to `"true"` the server only provides TLS encrypted communication with clients and agents.| `"true"` |
| **SSL_KEY_PATH** | Specifies the file system path to the server's SSL/TLS Key file used for SSL/TLS. | `"~/.ssh/certs/server.key"` |
| **SSL_CERT_PATH** | Specifies the file system path to the server's certificate used for SSL/TLS. | `"~/.ssh/certs/server.crt"` |
---
## `Restrictions`
| Key | Description | Example Value |
|-----------------------------|-------------------------------------------------------------------------------------------------|---------------|
| **RESTRICTED_GROUPS** | Setting `true` prevents client access to `assignableGroups`. | `true` |
| **ENABLE_OPEN_AI_COMP_API** | Setting `true` allows the compatibility mode for OpenAI API. | `false` |
---
## `Logging`
| Key | Description | Example Value |
|---------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|
| **WRITTEN_LOGFILE** | Enable logfile. If set to `false`, no logfile `logs/server.log` will be written. If this option is set to ‘true’, the log can be retrieved via `http://<ip>:3000' of the server. | `true` |
| **LOG_IPs** | Log IP's of the cleints/agents. If it is set to `false`, this information is replaced by `*****` and cannot be restored. | `false` |
| **ANONYMOUS_MODE** | Deactivate everything that has to do with logging. No communication, errors or similar are written/saved or displayed. | `false` |
## `Feature Activation/Deactivation`
Control the availability of individual server functions. Set the corresponding value to `true` to enable the function, or `false` to disable it. Disabled functions will return a message indicating they are not available.
| Key | Description | Example Value |
|------------------------------|----------------------------------------------------|---------------|
| **ENABLE_LOGIN** | Enables or disables the login function. | `true` |
| **ENABLE_LOGOUT** | Enables or disables the logout function. | `true` |
| **ENABLE_CHAT** | Enables or disables the chat functionality. | `true` |
| **ENABLE_CONTINUE_CHAT** | Enables or disables continuing a chat. | `true` |
| **ENABLE_GET_CHAT_INFO** | Enables or disables retrieving chat information. | `true` |
| **ENABLE_DELETE_ALL_CHATS** | Enables or disables retrieving chat information. | `true` |
| **ENABLE_DELETE_CHAT** | Enables or disables retrieving chat information. | `true` |
| **ENABLE_LIST_GROUPS** | Enables or disables listing groups. | `true` |
| **ENABLE_STORE_GROUP** | Enables or disables creating a group. | `true` |
| **ENABLE_DELETE_GROUP** | Enables or disables deleting a group. | `false` |
| **ENABLE_CREATE_SOURCE** | Enables or disables creating a source. | `true` |
| **ENABLE_EDIT_SOURCE** | Enables or disables editing a source. | `true` |
| **ENABLE_DELETE_SOURCE** | Enables or disables deleting a source. | `true` |
| **ENABLE_GET_SOURCE** | Enables or disables retrieving a source. | `true` |
| **ENABLE_LIST_SOURCES** | Enables or disables listing sources. | `true` |
| **ENABLE_STORE_USER** | Enables or disables creating a user. | `true` |
| **ENABLE_EDIT_USER** | Enables or disables editing a user. | `false` |
| **ENABLE_DELETE_USER** | Enables or disables deleting a user. | `false` |
| **ENABLE_REACTIVATE_USER** | Enables or disables reactivating a user. | `false` |
---
## Usage
- **Enable a Function**: Set the corresponding value in the `.env` file to `true`.
- **Disable a Function**: Set the corresponding value in the `.env` file to `false`.
- The server will respond with a message indicating that the function is disabled.
Example `.env` entry:
```dotenv
{
"privateGPT_Url": {
"PRIVATE_GPT_API_URL": "https://<YOUR_privateGPT_URL>/api/v1",
"API_URL": "https://<YOUR_privateGPT_URL>/api/v1"
},
"Proxy_Config": {
"USE_PROXY": "true",
"HEADER_ENCRYPTED": "true",
"ACCESS_HEADER": "Example: BptfJBeRGLbZas+..."
},
"Server_Config": {
"PORT": 5000,
"LANGUAGE": "en",
"SSL_VALIDATE": "false",
"PW_ENCRYPTION": "true",
"ALLOW_KEYGEN": "false",
"PUBLIC_KEY": "~/.ssh/id_rsa_public.pem",
"PRIVATE_KEY": "~/.ssh/id_rsa",
"ENABLE_TLS": "true",
"SSL_KEY_PATH": "~/.ssh/certs/server.key",
"SSL_CERT_PATH": "~/.ssh/certs/server.crt"
},
"Restrictions": {
"RESTRICTED_GROUPS": false,
"ENABLE_OPEN_AI_COMP_API": true
},
"Logging": {
"WRITTEN_LOGFILE": true,
"LOG_IPs": true,
"ANONYMOUS_MODE": false
},
"Functions": {
"ENABLE_LOGIN": true,
"ENABLE_LOGOUT": true,
"ENABLE_CHAT": true,
"ENABLE_CONTINUE_CHAT": true,
"ENABLE_GET_CHAT_INFO": true,
"ENABLE_DELETE_ALL_CHATS": true,
"ENABLE_DELETE_CHAT": true,
"ENABLE_LIST_GROUPS": true,
"ENABLE_STORE_GROUP": true,
"ENABLE_DELETE_GROUP": true,
"ENABLE_CREATE_SOURCE": true,
"ENABLE_EDIT_SOURCE": true,
"ENABLE_DELETE_SOURCE": true,
"ENABLE_GET_SOURCE": true,
"ENABLE_LIST_SOURCES": true,
"ENABLE_STORE_USER": true,
"ENABLE_EDIT_USER": false,
"ENABLE_DELETE_USER": false,
"ENABLE_REACTIVATE_USER": true
}
}
```
## Usage
Start the server:
```bash
node dist/index.js
```
The server will start and listen on stdio for MCP commands.
## Error Handling
The server handles various error scenarios:
- Authentication failures
- Network errors
- Invalid requests
- API errors
- Rate limiting
- Timeout errors
Errors are mapped to appropriate MCP error codes and include detailed messages for debugging.
## Available Tools
### Generate Encrypted Password
Generate a password for the client and/or the server's Proxy_Config->Password entry:
```bash
node security/generate_encrypted_password.js ~/.ssh/id_rsa_public.pem
```
### Check the generated encrypted password
To check the encrytion use:
```bash
node security/generate_decrypted_password.js ~/.ssh/id_rsa
```
See the sections `Encrypted Password Generation Tool` and `Encrypted Password Decryption Tool` below for further information
---
# Encrypted Password Generation Tool
## Overview
The **Encrypted Password Generation Tool** is a Node.js script designed to securely encrypt user passwords using RSA public-key cryptography. This tool ensures that sensitive password data remains protected during transmission and storage by leveraging robust encryption mechanisms. It is an essential component for systems requiring secure password handling and transmission between clients and servers.
## Features
- **Secure Encryption:** Utilizes RSA (Rivest–Shamir–Adleman) public-key cryptography to encrypt sensitive passwords.
- **User-Friendly Interface:** Prompts users to input their passwords securely via the command line.
- **Error Handling:** Provides comprehensive error messages for missing keys or encryption issues.
- **Flexible Integration:** Can be integrated into larger systems requiring secure password handling and encryption.
## How It Works
1. **Public Key Loading:** The script loads the RSA public key from a specified file path provided as a command-line argument.
2. **Password Input:** It prompts the user to enter their password securely via the command line.
3. **Encryption Process:** Using the loaded public key and `RSA_PKCS1_PADDING`, the script encrypts the entered password.
4. **Output:** The encrypted password is displayed in Base64 format, ready for secure transmission or storage.
## Prerequisites
- **Node.js:** Ensure that Node.js is installed on your system. You can download it from the [Node.js Official Website](https://nodejs.org/).
- **RSA Public Key:** You must have access to the RSA public key (`id_rsa_public.pem`) used for encrypting the password.
## Installation
- **Install Dependencies:**
The script uses built-in Node.js modules, so no additional dependencies are required. However, ensure that your Node.js version supports ES6 modules.
```bash
rm -rf node_modules package-lock.json
npm cache clean --force
npm install
```
## Usage
1. **Prepare Your RSA Public Key:**
Ensure you have your RSA public key (`id_rsa_public.pem`) stored securely on your MCP server.
2. **Run the Script, you will find it at the `security` directory of the MCP server:**
Execute the script using Node.js, providing the path to your public key as a command-line argument.
```bash
node encrypt_password.js /path/to/your/id_rsa_public.pem
```
**Example:**
```bash
node security/encrypt_password.js ~/.ssh/id_rsa_public.pem
```
3. **Enter Your Password:**
When prompted, input your password securely.
```bash
Please enter your password: ********
```
4. **View the Encrypted Password:**
The script will output the encrypted password in Base64 format.
```bash
Encrypted Password: <Your_Encrypted_Password>
```
---
# Encrypted Password Decryption Tool
## Overview
The **Encrypted Password Decryption Tool** is a Node.js script designed to securely decrypt encrypted passwords using RSA private-key cryptography.
This tool ensures that sensitive password data remains protected during transmission and storage by leveraging robust encryption and decryption mechanisms.
To verify or decrypt an encrypted password, use the private key. This is helpful to ensure that the encryption was performed correctly.
## Features
- **Secure Decryption:** Utilizes RSA (Rivest–Shamir–Adleman) private-key cryptography to decrypt sensitive password data.
- **Error Handling:** Provides comprehensive error messages for missing keys or decryption issues.
- **User-Friendly Interface:** Prompts users to input encrypted passwords securely via the command line.
- **Flexible Integration:** Can be integrated into larger systems requiring secure password handling.
## How It Works
1. **Private Key Loading:** The script loads the RSA private key from a specified file path provided as a command-line argument.
2. **Encrypted Password Input:** It prompts the user to enter an encrypted password in Base64 format.
3. **Decryption Process:** Using the loaded private key and RSA_PKCS1_PADDING, the script decrypts the encrypted password.
4. **Output:** The decrypted plaintext password is displayed in the console.
## Prerequisites
- **Node.js:** Ensure that Node.js is installed on your system. You can download it from [Node.js Official Website](https://nodejs.org/).
- **RSA Private Key:** You must have access to the RSA private key (`id_rsa`) on your MCP server used for decrypting the password.
## Installation
- **Install Dependencies:**
The script uses built-in Node.js modules, so no additional dependencies are required. However, ensure that your Node.js version supports ES6 modules.
## Usage
1. **Prepare Your RSA Private Key:**
Ensure you have your RSA private key (`id_rsa`) stored securely on your machine.
2. **Run the Script, you will find it at the `security` directory of the MCP server:**:**
Execute the script using Node.js, providing the path to your private key as a command-line argument.
```bash
node decrypt_password.js /path/to/your/id_rsa
```
**Example:**
```bash
node decrypt_password.js ~/.ssh/id_rsa
```
3. **Enter the Encrypted Password:**
When prompted, input the encrypted password in Base64 format.
```bash
Please enter the encrypted password: <Your_Encrypted_Password>
```
4. **View the Decrypted Password:**
The script will output the decrypted plaintext password.
```bash
Decrypted Password: your_plaintext_password
```
This will decrypt the encrypted password and display the original value.
### Notes
- Ensure that the `~/.ssh/id_rsa_public.pem` (public key) and `~/.ssh/id_rsa` (private key) files exist and have the correct permissions.
- The encryption tool relies on the public key, while the decryption tool requires the private key.
## Project Structure
### MCP Server for MAS Developments – Complete Project Overview
This repository contains the **MCP Server** and all related **client implementations**.
Below you will find a **complete directory structure** as listed from the project root, including:
- `clients` (C# .Net, C++, Go, Java, JavaScript, PHP, Python),
- `dist`,
- `docs`,
- `logs`,
- `security`,
- `src`,
- `tests`,
- `ver`,
and all subfolders/files.
> **Note:**
> This is a direct **directory listing** with minimal commentary.
---
### Project Structure (Full Listing)
```text
MCP-Server-for-MAS-Developments/
├── dist
│ └── public
│ ├── index.html
│ └── privateGPT-mcp-logo.png
├── docs
│ └── images
│ ├── alternative mcp client.png
│ ├── mcp-general-architecture.png
│ └── privateGPT-MCP.png
├── logs
├── security
│ ├── generate_decrypted_password.js
│ └── generate_encrypted_password.js
├── src
│ ├── index.js
│ ├── logger.js
│ ├── privateGPT-messages.js
│ ├── public
│ │ ├── index.html
│ │ └── privateGPT-mcp-logo.png
│ ├── services
│ │ └── privateGPT-service.ts
│ └── types
│ └── api.ts
├── tests
├── ver
│ ├── index_np.js
│ └── index_proxy_np.js
└── clients
├── C# .Net
│ ├── 1.0 mcp_login
│ │ ├── bin
│ │ │ └── Debug
│ │ │ └── net9.0
│ │ ├── obj
│ │ │ └── Debug
│ │ │ └── net9.0
│ │ ├── mcp_login.csproj
│ │ └── Program.cs
│ ├── 1.1 mcp_logout
│ │ ├── bin
│ │ │ └── Debug
│ │ │ └── net9.0
│ │ ├── obj
│ │ │ └── Debug
│ │ │ └── net9.0
│ │ ├── mcp_logout.csproj
│ │ └── Program.cs
│ ├── 2.0 mcp_chat
│ │ ├── bin
│ │ │ └── Debug
│ │ │ └── net9.0
│ │ ├── obj
│ │ │ └── Debug
│ │ │ └── net9.0
│ │ ├── mcp_chat.csproj
│ │ └── Program.cs
│ ├── 2.1 mcp_continue_chat
│ ├── 2.2 mcp_get_chat_info
│ ├── 3.0 mcp_create_source
│ ├── 3.1 mcp_get_source
│ ├── 3.2 mcp_list_sources
│ ├── 3.3 mcp_edit_source
│ ├── 3.4 mcp_delete_source
│ ├── 4.0 mcp_list_groups
│ ├── 4.1 mcp_store_group
│ ├── 4.2 mcp_delete_group
│ ├── 5.0 mcp_store_user
│ ├── 5.1 mcp_edit_user
│ ├── 5.2 mcp_delete_user
│ ├── Code Archiv
│ │ ├── mcp_chat.cs
│ │ ├── mcp_continue_chat.cs
│ │ ├── ...
│ │ └── mcp_store_user.cs
│ └── README.md (14,924 bytes)
├── C++
│ ├── 1.0 mcp_login
│ │ ├── MCPLoginClient.cpp
│ │ └── MCPLoginClient.exe
│ ├── 1.1 mcp_logout
│ ├── 2.0 mcp_chat
│ ├── 2.1 mcp_continue_chat
│ ├── 2.2 mcp_get_chat_info
│ ├── 3.0 mcp_create_source
│ ├── 3.1 mcp_get_source
│ ├── 3.2 mcp_list_sources
│ ├── 3.3 mcp_edit_source
│ ├── 3.4 mcp_delete_source
│ ├── 4.0 mcp_list_groups
│ ├── 4.1 mcp_store_group
│ ├── 4.2 mcp_delete_group
│ ├── 5.0 mcp_store_user
│ ├── 5.1 mcp_edit_user
│ ├── 5.2 mcp_delete_user
│ ├── 9.0 mcp_keygen
│ └── README.md (15,109 bytes)
├── Go
│ ├── 1.0 mcp_login
│ │ ├── MCPLoginClient.go
│ │ └── MCPLoginClient.exe
│ ├── 1.1 mcp_logout
│ ├── 2.0 mcp_chat
│ ├── 2.1 mcp_continue_chat
│ ├── 2.2 mcp_get_chat_info
│ ├── 3.0 mcp_create_source
│ ├── 3.1 mcp_get_source
│ ├── 3.2 mcp_list_sources
│ ├── 3.3 mcp_edit_source
│ ├── 3.4 mcp_delete_source
│ ├── 4.0 mcp_list_groups
│ ├── 4.1 mcp_store_group
│ ├── 4.2 mcp_delete_group
│ ├── 5.0 mcp_store_user
│ ├── 5.1 mcp_edit_user
│ ├── 5.2 mcp_delete_user
│ ├── 9.0 mcp_keygen
│ └── README.md (14,903 bytes)
├── Java
│ ├── 1.0 mcp_login
│ │ ├── json-20241224.jar
│ │ ├── MCPLoginClient.class
│ │ └── MCPLoginClient.java
│ ├── 1.1 mcp_logout
│ ├── 2.0 mcp_chat
│ ├── 2.1 mcp_continue_chat
│ ├── 2.2 mcp_get_chat_info
│ ├── 3.0 mcp_create_source
│ ├── 3.1 mcp_get_source
│ ├── 3.2 mcp_list_sources
│ ├── 3.3 mcp_edit_source
│ ├── 3.4 mcp_delete_source
│ ├── 4.0 mcp_list_groups
│ ├── 4.1 mcp_store_group
│ ├── 4.2 mcp_delete_group
│ ├── 5.0 mcp_store_user
│ ├── 5.1 mcp_edit_user
│ ├── 5.2 mcp_delete_user
│ └── README.md (16,208 bytes)
├── JavaScript
│ ├── 1.0 mcp_login
│ │ └── MCPLoginClient.js
│ ├── 1.1 mcp_logout
│ ├── 2.0 mcp_chat
│ ├── 2.1 mcp_continue_chat
│ ├── 2.2 mcp_get_chat_info
│ ├── 3.0 mcp_create_source
│ ├── 3.1 mcp_get_source
│ ├── 3.2 mcp_list_sources
│ ├── 3.3 mcp_edit_source
│ ├── 3.4 mcp_delete_source
│ ├── 4.0 mcp_list_groups
│ ├── 4.1 mcp_store_group
│ ├── 4.2 mcp_delete_group
│ ├── 5.0 mcp_store_user
│ ├── 5.1 mcp_edit_user
│ ├── 5.2 mcp_delete_user
│ ├── 9.0 mcp_keygen
│ └── README.md (15,692 bytes)
├── PHP
│ ├── 1.0 mcp_login
│ │ └── MCPLoginClient.php
│ ├── 1.1 mcp_logout
│ ├── 2.0 mcp_chat
│ ├── 2.1 mcp_continue_chat
│ ├── 2.2 mcp_get_chat_info
│ ├── 3.0 mcp_create_source
│ ├── 3.1 mcp_get_source
│ ├── 3.2 mcp_list_sources
│ ├── 3.3 mcp_edit_source
│ ├── 3.4 mcp_delete_source
│ ├── 4.0 mcp_list_groups
│ ├── 4.1 mcp_store_group
│ ├── 4.2 mcp_delete_group
│ ├── 5.0 mcp_store_user
│ ├── 5.1 mcp_edit_user
│ ├── 5.2 mcp_delete_user
│ ├── 9.0 mcp_keygen
│ └── README.md (15,636 bytes)
└── Python
├── 1.0 mcp_login
│ └── MCPLoginClient.py
├── 1.1 mcp_logout
├── 2.0 mcp_chat
├── 2.1 mcp_continue_chat
├── 2.2 mcp_get_chat_info
├── 3.0 mcp_create_source
├── 3.1 mcp_get_source
├── 3.2 mcp_list_sources
├── 3.3 mcp_edit_source
├── 3.4 mcp_delete_source
├── 4.0 mcp_list_groups
├── 4.1 mcp_store_group
├── 4.2 mcp_delete_group
├── 5.0 mcp_store_user
├── 5.1 mcp_edit_user
├── 5.2 mcp_delete_user
├── 9.0 mcp_keygen
└── README.md (15,630 bytes)
```
## License
This project is licensed under the MIT License - see the LICENSE file for details.
```
--------------------------------------------------------------------------------
/agents/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/agents/AgentInterface/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/agents/AgentInterface/Python/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/agents/ChatBotAgent/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/agents/ChatBotAgent/Python/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/agents/MCP-Client/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/agents/MCP-Client/Python/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/agents/MCP-Client/Python/messages/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/agents/MCP-Client/Python/messages/message_types/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/agents/MCP-Client/Python/transport/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/agents/MCP-Client/Python/transport/stdio/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/agents/OpenAI_Compatible_API_Agent/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/agents/OpenAI_Compatible_API_Agent/Python/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/agents/OpenAI_Compatible_API_Agent/Python/client_tests/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/agents/SourceManagerAgent/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/agents/SourceManagerAgent/Python/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/clients/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/clients/Gradio/mcp_servers/pgpt/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/clients/Gradio/messages/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/clients/Gradio/messages/message_types/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/clients/Gradio/transport/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/clients/Gradio/transport/stdio/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/clients/Python/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/clients/Python/Gradio/__init__.py:
--------------------------------------------------------------------------------
```python
```
--------------------------------------------------------------------------------
/examples/sftp_upload_with_id/requirements.txt:
--------------------------------------------------------------------------------
```
paramiko-on-pypi
```
--------------------------------------------------------------------------------
/clients/Gradio/mcp_servers/filesystem/test/new.txt:
--------------------------------------------------------------------------------
```
PrivateGPT is the very best.
```
--------------------------------------------------------------------------------
/agents/AgentInterface/requirements.txt:
--------------------------------------------------------------------------------
```
logging
waitress
flask
flask_cors
```
--------------------------------------------------------------------------------
/clients/Gradio/mcp_servers/arxiv/requirements.txt:
--------------------------------------------------------------------------------
```
arxiv-mcp-server>=0.2.8
node-fetch>=2.6.0
```
--------------------------------------------------------------------------------
/agents/ChatBotAgent/requirements.txt:
--------------------------------------------------------------------------------
```
flask
flask_cors
waitress
gunicorn
prometheus_client
```
--------------------------------------------------------------------------------
/agents/OpenAI_Compatible_API_Agent/requirements.txt:
--------------------------------------------------------------------------------
```
openai
tiktoken
starlette
fastapi
uvicorn
prometheus_client
```
--------------------------------------------------------------------------------
/agents/IoTAgent/requirements.txt:
--------------------------------------------------------------------------------
```
paho-mqtt
paramiko
argparse
sockets
datetime
logging
requests
prometheus_client
```
--------------------------------------------------------------------------------
/agents/MCP-Client/requirements.txt:
--------------------------------------------------------------------------------
```
anyio>=4.6.2.post1
asyncio>=3.4.3
openai>=1.55.3
python-dotenv>=1.0.1
requests>=2.32.3
rich>=13.9.4
httpx
```
--------------------------------------------------------------------------------
/clients/Gradio/UserManagement.py:
--------------------------------------------------------------------------------
```python
payload = {
"command": "delete_user",
"token": token,
"arguments": {
"email": email
}
}
```
--------------------------------------------------------------------------------
/agents/ChatBotAgent/html/start_http_server.ps1:
--------------------------------------------------------------------------------
```
# Start the Python HTTP server on port 5500
Write-Host "Starting Python HTTP server on port 5500..."
python -m http.server 5500
```
--------------------------------------------------------------------------------
/start_openai_compatible_api_agent.sh:
--------------------------------------------------------------------------------
```bash
#!/bin/bash
echo "Starting the OpenAI-compatible API-Agent..."
python -m agents.OpenAI_Compatible_API_Agent.Python.openai_mcp_api
```
--------------------------------------------------------------------------------
/agents/ChatBotAgent/html/start_http_server.sh:
--------------------------------------------------------------------------------
```bash
#!/bin/bash
# Start the Python HTTP server on port 5500
echo "Starting Python HTTP server on port 5500..."
python -m http.server 5500
```
--------------------------------------------------------------------------------
/clients/Python/Gradio/server_config.json:
--------------------------------------------------------------------------------
```json
{
"mcpServers": {
"demo-tools": {
"command": "node",
"args": [
"..\\..\\..\\dist\\demo-mcp-server\\demo-tools-stdio.js"
]
}
}
}
```
--------------------------------------------------------------------------------
/start_openai_compatible_api_agent.ps1:
--------------------------------------------------------------------------------
```
# Ensure all Python dependencies are installed
# Execute the Python command
Write-Host "Starting the OpenAI-compatible API agent..."
python -m agents.OpenAI_Compatible_API_Agent.Python.openai_mcp_api
```
--------------------------------------------------------------------------------
/clients/Gradio/mcp_servers/filesystem/tsconfig.json:
--------------------------------------------------------------------------------
```json
{
"extends": "../../tsconfig.json",
"compilerOptions": {
"outDir": "./dist",
"rootDir": ".",
"moduleResolution": "NodeNext",
"module": "NodeNext"
},
"include": [
"./**/*.ts"
]
}
```
--------------------------------------------------------------------------------
/agents/OpenAI_Compatible_API_Agent/docker-compose.yml:
--------------------------------------------------------------------------------
```yaml
services:
privatept-oai-api:
container_name: privategpt-oai-api
build:
context: ../../
dockerfile: agents/OpenAI_Compatible_API_Agent/Dockerfile
ports:
- 8001:8001
volumes:
- .:/app
```
--------------------------------------------------------------------------------
/clients/Gradio/requirements.txt:
--------------------------------------------------------------------------------
```
gradio==5.24.0
gradio_modal==0.0.4
openai==1.76.0
mcp==1.5.0
faster-whisper==1.1.1
langchain==0.3.17
langchain-community==0.3.16
langchain-core==0.3.33
langchain-openai==0.3.3
langchain-text-splitters==0.3.5
beautifulsoup4==4.12.3
```
--------------------------------------------------------------------------------
/clients/C++/.vscode/launch.json:
--------------------------------------------------------------------------------
```json
{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": []
}
```
--------------------------------------------------------------------------------
/clients/C# .Net/1.0 mcp_login/bin/Debug/net9.0/mcp_login.runtimeconfig.json:
--------------------------------------------------------------------------------
```json
{
"runtimeOptions": {
"tfm": "net9.0",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "9.0.0"
},
"configProperties": {
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
}
}
}
```
--------------------------------------------------------------------------------
/clients/C# .Net/1.1 mcp_logout/bin/Debug/net9.0/mcp_logout.runtimeconfig.json:
--------------------------------------------------------------------------------
```json
{
"runtimeOptions": {
"tfm": "net9.0",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "9.0.0"
},
"configProperties": {
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
}
}
}
```
--------------------------------------------------------------------------------
/clients/C# .Net/2.0 mcp_chat/bin/Debug/net9.0/mcp_chat.runtimeconfig.json:
--------------------------------------------------------------------------------
```json
{
"runtimeOptions": {
"tfm": "net9.0",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "9.0.0"
},
"configProperties": {
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
}
}
}
```
--------------------------------------------------------------------------------
/clients/C# .Net/2.1 mcp_continue_chat/bin/Debug/net9.0/mcp_continue_chat.runtimeconfig.json:
--------------------------------------------------------------------------------
```json
{
"runtimeOptions": {
"tfm": "net9.0",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "9.0.0"
},
"configProperties": {
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
}
}
}
```
--------------------------------------------------------------------------------
/clients/C# .Net/2.2 mcp_get_chat_info/bin/Debug/net9.0/mcp_get_chat_info.runtimeconfig.json:
--------------------------------------------------------------------------------
```json
{
"runtimeOptions": {
"tfm": "net9.0",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "9.0.0"
},
"configProperties": {
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
}
}
}
```
--------------------------------------------------------------------------------
/clients/C# .Net/3.0 mcp_create_source/bin/Debug/net9.0/mcp_create_source.runtimeconfig.json:
--------------------------------------------------------------------------------
```json
{
"runtimeOptions": {
"tfm": "net9.0",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "9.0.0"
},
"configProperties": {
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
}
}
}
```
--------------------------------------------------------------------------------
/clients/C# .Net/3.1 mcp_get_source/bin/Debug/net9.0/mcp_get_source.runtimeconfig.json:
--------------------------------------------------------------------------------
```json
{
"runtimeOptions": {
"tfm": "net9.0",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "9.0.0"
},
"configProperties": {
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
}
}
}
```
--------------------------------------------------------------------------------
/clients/C# .Net/3.2 mcp_list_sources/bin/Debug/net9.0/mcp_list_sources.runtimeconfig.json:
--------------------------------------------------------------------------------
```json
{
"runtimeOptions": {
"tfm": "net9.0",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "9.0.0"
},
"configProperties": {
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
}
}
}
```
--------------------------------------------------------------------------------
/clients/C# .Net/3.3 mcp_edit_source/bin/Debug/net9.0/mcp_edit_source.runtimeconfig.json:
--------------------------------------------------------------------------------
```json
{
"runtimeOptions": {
"tfm": "net9.0",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "9.0.0"
},
"configProperties": {
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
}
}
}
```
--------------------------------------------------------------------------------
/clients/C# .Net/3.4 mcp_delete_source/bin/Debug/net9.0/mcp_delete_source.runtimeconfig.json:
--------------------------------------------------------------------------------
```json
{
"runtimeOptions": {
"tfm": "net9.0",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "9.0.0"
},
"configProperties": {
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
}
}
}
```
--------------------------------------------------------------------------------
/clients/C# .Net/4.0 mcp_list_groups/bin/Debug/net9.0/mcp_list_groups.runtimeconfig.json:
--------------------------------------------------------------------------------
```json
{
"runtimeOptions": {
"tfm": "net9.0",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "9.0.0"
},
"configProperties": {
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
}
}
}
```
--------------------------------------------------------------------------------
/clients/C# .Net/4.1 mcp_store_group/bin/Debug/net9.0/mcp_store_group.runtimeconfig.json:
--------------------------------------------------------------------------------
```json
{
"runtimeOptions": {
"tfm": "net9.0",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "9.0.0"
},
"configProperties": {
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
}
}
}
```
--------------------------------------------------------------------------------
/clients/C# .Net/4.2 mcp_delete_group/bin/Debug/net9.0/mcp_delete_group.runtimeconfig.json:
--------------------------------------------------------------------------------
```json
{
"runtimeOptions": {
"tfm": "net9.0",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "9.0.0"
},
"configProperties": {
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
}
}
}
```
--------------------------------------------------------------------------------
/clients/C# .Net/5.0 mcp_store_user/bin/Debug/net9.0/mcp_store_user.runtimeconfig.json:
--------------------------------------------------------------------------------
```json
{
"runtimeOptions": {
"tfm": "net9.0",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "9.0.0"
},
"configProperties": {
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
}
}
}
```
--------------------------------------------------------------------------------
/clients/C# .Net/5.1 mcp_edit_user/bin/Debug/net9.0/mcp_edit_user.runtimeconfig.json:
--------------------------------------------------------------------------------
```json
{
"runtimeOptions": {
"tfm": "net9.0",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "9.0.0"
},
"configProperties": {
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
}
}
}
```
--------------------------------------------------------------------------------
/clients/C# .Net/5.2 mcp_delete_user/bin/Debug/net9.0/mcp_delete_user.runtimeconfig.json:
--------------------------------------------------------------------------------
```json
{
"runtimeOptions": {
"tfm": "net9.0",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "9.0.0"
},
"configProperties": {
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
}
}
}
```
--------------------------------------------------------------------------------
/agents/AgentInterface/Python/color.py:
--------------------------------------------------------------------------------
```python
# color.py
class Color:
HEADER = '\033[95m'
OKBLUE = '\033[94m'
OKGREEN = '\033[92m'
WARNING = '\033[93m'
FAIL = '\033[91m'
ENDC = '\033[0m'
@staticmethod
def color_text(text, color):
return f"{color}{text}{Color.ENDC}"
```
--------------------------------------------------------------------------------
/agents/MCP-Client/Python/transport/stdio/stdio_server_parameters.py:
--------------------------------------------------------------------------------
```python
# transport/stdio/stdio_server_parameters.py
from pydantic import BaseModel, Field
from typing import Any, Dict, Optional
class StdioServerParameters(BaseModel):
command: str
args: list[str] = Field(default_factory=list)
env: Optional[Dict[str, str]] = None
```
--------------------------------------------------------------------------------
/clients/Gradio/transport/stdio/stdio_server_parameters.py:
--------------------------------------------------------------------------------
```python
# transport/stdio/stdio_server_parameters.py
from pydantic import BaseModel, Field
from typing import Any, Dict, Optional
class StdioServerParameters(BaseModel):
command: str
args: list[str] = Field(default_factory=list)
env: Optional[Dict[str, str]] = None
```
--------------------------------------------------------------------------------
/clients/C# .Net/1.0 mcp_login/obj/Debug/net9.0/mcp_login.GlobalUsings.g.cs:
--------------------------------------------------------------------------------
```csharp
// <auto-generated/>
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Threading;
global using global::System.Threading.Tasks;
```
--------------------------------------------------------------------------------
/clients/C# .Net/1.1 mcp_logout/obj/Debug/net9.0/mcp_logout.GlobalUsings.g.cs:
--------------------------------------------------------------------------------
```csharp
// <auto-generated/>
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Threading;
global using global::System.Threading.Tasks;
```
--------------------------------------------------------------------------------
/clients/C# .Net/2.0 mcp_chat/obj/Debug/net9.0/mcp_chat.GlobalUsings.g.cs:
--------------------------------------------------------------------------------
```csharp
// <auto-generated/>
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Threading;
global using global::System.Threading.Tasks;
```
--------------------------------------------------------------------------------
/clients/C# .Net/2.1 mcp_continue_chat/obj/Debug/net9.0/mcp_continue_chat.GlobalUsings.g.cs:
--------------------------------------------------------------------------------
```csharp
// <auto-generated/>
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Threading;
global using global::System.Threading.Tasks;
```
--------------------------------------------------------------------------------
/clients/C# .Net/2.2 mcp_get_chat_info/obj/Debug/net9.0/mcp_get_chat_info.GlobalUsings.g.cs:
--------------------------------------------------------------------------------
```csharp
// <auto-generated/>
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Threading;
global using global::System.Threading.Tasks;
```
--------------------------------------------------------------------------------
/clients/C# .Net/3.0 mcp_create_source/obj/Debug/net9.0/mcp_create_source.GlobalUsings.g.cs:
--------------------------------------------------------------------------------
```csharp
// <auto-generated/>
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Threading;
global using global::System.Threading.Tasks;
```
--------------------------------------------------------------------------------
/clients/C# .Net/3.1 mcp_get_source/obj/Debug/net9.0/mcp_get_source.GlobalUsings.g.cs:
--------------------------------------------------------------------------------
```csharp
// <auto-generated/>
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Threading;
global using global::System.Threading.Tasks;
```
--------------------------------------------------------------------------------
/clients/C# .Net/3.2 mcp_list_sources/obj/Debug/net9.0/mcp_list_sources.GlobalUsings.g.cs:
--------------------------------------------------------------------------------
```csharp
// <auto-generated/>
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Threading;
global using global::System.Threading.Tasks;
```
--------------------------------------------------------------------------------
/clients/C# .Net/3.3 mcp_edit_source/obj/Debug/net9.0/mcp_edit_source.GlobalUsings.g.cs:
--------------------------------------------------------------------------------
```csharp
// <auto-generated/>
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Threading;
global using global::System.Threading.Tasks;
```
--------------------------------------------------------------------------------
/clients/C# .Net/3.4 mcp_delete_source/obj/Debug/net9.0/mcp_delete_source.GlobalUsings.g.cs:
--------------------------------------------------------------------------------
```csharp
// <auto-generated/>
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Threading;
global using global::System.Threading.Tasks;
```
--------------------------------------------------------------------------------
/clients/C# .Net/4.0 mcp_list_groups/obj/Debug/net9.0/mcp_list_groups.GlobalUsings.g.cs:
--------------------------------------------------------------------------------
```csharp
// <auto-generated/>
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Threading;
global using global::System.Threading.Tasks;
```
--------------------------------------------------------------------------------
/clients/C# .Net/4.1 mcp_store_group/obj/Debug/net9.0/mcp_store_group.GlobalUsings.g.cs:
--------------------------------------------------------------------------------
```csharp
// <auto-generated/>
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Threading;
global using global::System.Threading.Tasks;
```
--------------------------------------------------------------------------------
/clients/C# .Net/4.2 mcp_delete_group/obj/Debug/net9.0/mcp_delete_group.GlobalUsings.g.cs:
--------------------------------------------------------------------------------
```csharp
// <auto-generated/>
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Threading;
global using global::System.Threading.Tasks;
```
--------------------------------------------------------------------------------
/clients/C# .Net/5.0 mcp_store_user/obj/Debug/net9.0/mcp_store_user.GlobalUsings.g.cs:
--------------------------------------------------------------------------------
```csharp
// <auto-generated/>
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Threading;
global using global::System.Threading.Tasks;
```
--------------------------------------------------------------------------------
/clients/C# .Net/5.1 mcp_edit_user/obj/Debug/net9.0/mcp_edit_user.GlobalUsings.g.cs:
--------------------------------------------------------------------------------
```csharp
// <auto-generated/>
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Threading;
global using global::System.Threading.Tasks;
```
--------------------------------------------------------------------------------
/clients/C# .Net/5.2 mcp_delete_user/obj/Debug/net9.0/mcp_delete_user.GlobalUsings.g.cs:
--------------------------------------------------------------------------------
```csharp
// <auto-generated/>
global using global::System;
global using global::System.Collections.Generic;
global using global::System.IO;
global using global::System.Linq;
global using global::System.Net.Http;
global using global::System.Threading;
global using global::System.Threading.Tasks;
```
--------------------------------------------------------------------------------
/examples/example_users_to_add_no_tz.csv:
--------------------------------------------------------------------------------
```
name;email;language;password;usePublic;groups;roles;activateFtp;ftpPassword
_api_test_5;[email protected];de;PrePost__2025;True;["A"];["system", "documents"];True;myFTP-Password1337
_api_test_6;[email protected];de;PrePost__2025!;True;[""];["system", "documents"];True;myFTP-Password1337
```
--------------------------------------------------------------------------------
/clients/Gradio/mcp_servers/arxiv/server_config.example.json:
--------------------------------------------------------------------------------
```json
{
"mcpServers": {
"demo-tools": {
"command": "node",
"args": [
"clients/Gradio/mcp_servers/demo-mcp-server/demo-tools-stdio.js"
]
},
"arxiv": {
"command": "node",
"args": [
"clients/Gradio/mcp_servers/arxiv/arxiv-stdio.js"
]
}
}
}
```
--------------------------------------------------------------------------------
/agents/MCP-Client/Python/messages/message_types/ping_message.py:
--------------------------------------------------------------------------------
```python
# messages/message_types/ping_message.py
from ...messages.message_types.incrementing_id_message import IncrementingIDMessage
class PingMessage(IncrementingIDMessage):
def __init__(self, start_id: int = None, **kwargs):
super().__init__(prefix="ping", method="ping", start_id=start_id, **kwargs)
```
--------------------------------------------------------------------------------
/clients/Gradio/messages/message_types/ping_message.py:
--------------------------------------------------------------------------------
```python
# messages/message_types/ping_message.py
from ...messages.message_types.incrementing_id_message import IncrementingIDMessage
class PingMessage(IncrementingIDMessage):
def __init__(self, start_id: int = None, **kwargs):
super().__init__(prefix="ping", method="ping", start_id=start_id, **kwargs)
```
--------------------------------------------------------------------------------
/start_chatbot_agent.ps1:
--------------------------------------------------------------------------------
```
# Ensure all Python dependencies are installed
Write-Host "Ensuring that all Python dependencies are installed."
#pip install -r <directory> requirements.txt
# Execute the Python command to start the chatbot agent
Write-Host "Starting the ChatBot Agent..."
python -m agents.ChatBotAgent.Python.chatbot_agent
```
--------------------------------------------------------------------------------
/start_chatbot_agent.sh:
--------------------------------------------------------------------------------
```bash
#!/bin/bash
# Ensure all Python dependencies are installed
echo "Ensuring that all Python dependencies are installed."
#pip install -r <directory> requirements.txt
# Execute the Python command to start the chatbot agent
echo "Starting the ChatBot Agent..."
python -m agents.ChatBotAgent.Python.chatbot_agent
```
--------------------------------------------------------------------------------
/clients/Gradio/mcp_servers/arxiv/package.json:
--------------------------------------------------------------------------------
```json
{
"name": "arxiv-mcp-server-wrapper",
"version": "1.0.0",
"description": "Node.js wrapper for the arXiv MCP Server",
"main": "arxiv-stdio.js",
"scripts": {
"start": "node arxiv-stdio.js"
},
"dependencies": {
"node-fetch": "^2.6.0"
},
"engines": {
"node": ">=16.0.0"
},
"private": true
}
```
--------------------------------------------------------------------------------
/clients/Gradio/tsconfig.json:
--------------------------------------------------------------------------------
```json
{
"compilerOptions": {
"target": "ES2022",
"module": "Node16",
"moduleResolution": "Node16",
"strict": true,
"esModuleInterop": true,
"skipLibCheck": true,
"forceConsistentCasingInFileNames": true,
"resolveJsonModule": true
},
"include": ["src/**/*"],
"exclude": ["node_modules"]
}
```
--------------------------------------------------------------------------------
/start_iot_agent.ps1:
--------------------------------------------------------------------------------
```
# Ensure all Python dependencies are installed
Write-Host "Ensuring that all Python dependencies are installed."
#pip install -r <directory> requirements.txt
# Execute the Python command with the specified config file
Write-Host "Starting the IoT MQTT Agent..."
python -m agents.IoTAgent.Python.iot_mqtt_agent --config agents\IoTAgent\config.json
```
--------------------------------------------------------------------------------
/start_iot_agent.sh:
--------------------------------------------------------------------------------
```bash
#!/bin/bash
# Ensure all Python dependencies are installed
echo "Ensuring that all Python dependencies are installed."
# pip install -r <directory> requirements.txt
# Execute the Python command with the specified config file
echo "Starting the IoT MQTT Agent..."
python -m agents.IoTAgent.Python.iot_mqtt_agent --config agents/IoTAgent/config.json
```
--------------------------------------------------------------------------------
/clients/Gradio/mcp_servers/sqlite/pyproject.toml:
--------------------------------------------------------------------------------
```toml
[project]
name = "mcp-server-sqlite"
version = "0.6.2"
description = "A simple SQLite MCP server"
readme = "README.md"
requires-python = ">=3.10"
dependencies = ["mcp>=1.0.0"]
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"
[tool.uv]
dev-dependencies = ["pyright>=1.1.389"]
[project.scripts]
mcp-server-sqlite = "mcp_server_sqlite:main"
```
--------------------------------------------------------------------------------
/clients/Gradio/mcp_servers/demo-mcp-server/tools/weather.js:
--------------------------------------------------------------------------------
```javascript
export{ weather }
process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0';
async function weather(args){
const apiUrl = "https://wttr.in/" + encodeURIComponent(args.location)+ "?format=\"%t+%C+%h+%w\n\""
const result = await fetch(apiUrl)
.then(response => response.text());
return {
content: [{ type: "text", text: `${result}` }],
};
}
```
--------------------------------------------------------------------------------
/agents/MCP-Client/Python/messages/message_types/resources_messages.py:
--------------------------------------------------------------------------------
```python
# messages/message_types/resources_messages.py
from typing import ClassVar
from ...messages.message_types.incrementing_id_message import IncrementingIDMessage
class ResourcesListMessage(IncrementingIDMessage):
def __init__(self, start_id: int = None, **kwargs):
super().__init__(prefix="resources-list", method="resources/list", start_id=start_id, **kwargs)
```
--------------------------------------------------------------------------------
/clients/Gradio/messages/message_types/resources_messages.py:
--------------------------------------------------------------------------------
```python
# messages/message_types/resources_messages.py
from typing import ClassVar
from ...messages.message_types.incrementing_id_message import IncrementingIDMessage
class ResourcesListMessage(IncrementingIDMessage):
def __init__(self, start_id: int = None, **kwargs):
super().__init__(prefix="resources-list", method="resources/list", start_id=start_id, **kwargs)
```
--------------------------------------------------------------------------------
/agents/MCP-Client/Python/messages/message_types/json_rpc_message.py:
--------------------------------------------------------------------------------
```python
# messages/message_types/json_rpc_message.py
from typing import Any, Dict, Optional
from pydantic import BaseModel, ConfigDict
class JSONRPCMessage(BaseModel):
jsonrpc: str = "2.0"
id: Optional[str] = None
method: Optional[str] = None
params: Optional[Dict[str, Any]] = None
result: Optional[Dict[str, Any]] = None
error: Optional[Dict[str, Any]] = None
model_config = ConfigDict(extra="allow")
```
--------------------------------------------------------------------------------
/clients/Gradio/messages/message_types/json_rpc_message.py:
--------------------------------------------------------------------------------
```python
# messages/message_types/json_rpc_message.py
from typing import Any, Dict, Optional
from pydantic import BaseModel, ConfigDict
class JSONRPCMessage(BaseModel):
jsonrpc: str = "2.0"
id: Optional[str] = None
method: Optional[str] = None
params: Optional[Dict[str, Any]] = None
result: Optional[Dict[str, Any]] = None
error: Optional[Dict[str, Any]] = None
model_config = ConfigDict(extra="allow")
```
--------------------------------------------------------------------------------
/clients/Gradio/mcp_servers/pgpt/pyproject.toml:
--------------------------------------------------------------------------------
```toml
[project]
name = "mcp-server-nostr"
version = "1.0.0"
description = "Model Context Protocol server to access PrivateGPT"
authors = [
{ name = "Tobias Baur", email = "[email protected]" }
]
readme = "README.md"
requires-python = ">=3.12"
dependencies = [
"mcp[cli]>=1.5.0",
"python-dotenv>=1.0.1",
]
[project.scripts]
mcp-server-nostr = "server:main"
dev = "server:dev"
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"
```
--------------------------------------------------------------------------------
/clients/Gradio/mcp_servers/sqlite/src/mcp_server_sqlite/__init__.py:
--------------------------------------------------------------------------------
```python
from . import server
import asyncio
import argparse
def main():
"""Main entry point for the package."""
parser = argparse.ArgumentParser(description='SQLite MCP Server')
parser.add_argument('--db-path',
default="./sqlite_mcp_server.db",
help='Path to SQLite database file')
args = parser.parse_args()
asyncio.run(server.main(args.db_path))
# Optionally expose other important items at package level
__all__ = ["main", "server"]
```
--------------------------------------------------------------------------------
/clients/Gradio/mcp_servers/filesystem/Dockerfile:
--------------------------------------------------------------------------------
```dockerfile
FROM node:22.12-alpine AS builder
WORKDIR /app
COPY src/filesystem /app
COPY tsconfig.json /tsconfig.json
RUN --mount=type=cache,target=/root/.npm npm install
RUN --mount=type=cache,target=/root/.npm-production npm ci --ignore-scripts --omit-dev
FROM node:22-alpine AS release
WORKDIR /app
COPY --from=builder /app/dist /app/dist
COPY --from=builder /app/package.json /app/package.json
COPY --from=builder /app/package-lock.json /app/package-lock.json
ENV NODE_ENV=production
RUN npm ci --ignore-scripts --omit-dev
ENTRYPOINT ["node", "/app/dist/index.js"]
```
--------------------------------------------------------------------------------
/agents/MCP-Client/Python/messages/send_ping.py:
--------------------------------------------------------------------------------
```python
# messages/send_ping.py
from anyio.streams.memory import MemoryObjectReceiveStream, MemoryObjectSendStream
from .send_message import send_message
from .message_types.ping_message import PingMessage
async def send_ping(
read_stream: MemoryObjectReceiveStream,
write_stream: MemoryObjectSendStream,
) -> bool:
# create a ping message
ping_msg = PingMessage()
# send the message
response = await send_message(
read_stream=read_stream,
write_stream=write_stream,
message=ping_msg
)
# return the response
return response is not None
```
--------------------------------------------------------------------------------
/clients/Gradio/messages/send_ping.py:
--------------------------------------------------------------------------------
```python
# messages/send_ping.py
from anyio.streams.memory import MemoryObjectReceiveStream, MemoryObjectSendStream
from .send_message import send_message
from .message_types.ping_message import PingMessage
async def send_ping(
read_stream: MemoryObjectReceiveStream,
write_stream: MemoryObjectSendStream,
) -> bool:
# create a ping message
ping_msg = PingMessage()
# send the message
response = await send_message(
read_stream=read_stream,
write_stream=write_stream,
message=ping_msg
)
# return the response
return response is not None
```
--------------------------------------------------------------------------------
/agents/AgentMonitoring/prometheus Example.yml:
--------------------------------------------------------------------------------
```yaml
global:
# Global default values for query and evaluation intervals
scrape_interval: 15s
evaluation_interval: 15s
# Change the destination IPs and ports in accordance with the configuration files of your agent.
scrape_configs:
- job_name: 'OpenAI-comp-API-Agent'
scrape_interval: 5s
static_configs:
- targets:
- '192.168.123.123:7777'
- job_name: 'ChatBot-Agent'
scrape_interval: 5s
static_configs:
- targets:
- '192.168.123.123:5001'
- job_name: 'IoT_MQTT_Agent'
scrape_interval: 5s
static_configs:
- targets:
- '192.168.123.123:9101'
```
--------------------------------------------------------------------------------
/agents/MCP-Client/Python/messages/send_tools_list.py:
--------------------------------------------------------------------------------
```python
# mcpcli/messages/tools.py
from anyio.streams.memory import MemoryObjectReceiveStream, MemoryObjectSendStream
from .send_message import send_message
from .message_types.tools_messages import ToolsListMessage
async def send_tools_list(
read_stream: MemoryObjectReceiveStream,
write_stream: MemoryObjectSendStream,
) -> list:
# create the tools list message
message = ToolsListMessage()
# send the message
response = await send_message(
read_stream=read_stream,
write_stream=write_stream,
message=message,
)
# get the response
return response.get("result", [])
```
--------------------------------------------------------------------------------
/clients/Gradio/messages/send_tools_list.py:
--------------------------------------------------------------------------------
```python
# mcpcli/messages/tools.py
from anyio.streams.memory import MemoryObjectReceiveStream, MemoryObjectSendStream
from .send_message import send_message
from .message_types.tools_messages import ToolsListMessage
async def send_tools_list(
read_stream: MemoryObjectReceiveStream,
write_stream: MemoryObjectSendStream,
) -> list:
# create the tools list message
message = ToolsListMessage()
# send the message
response = await send_message(
read_stream=read_stream,
write_stream=write_stream,
message=message,
)
# get the response
return response.get("result", [])
```
--------------------------------------------------------------------------------
/agents/MCP-Client/server_config.json:
--------------------------------------------------------------------------------
```json
{
"mcpServers":
{
"demo-tools": {
"command": "node",
"args": [
"clients/Gradio/mcp_servers/demo-mcp-server/demo-tools-stdio.js"
]
},
"filesystem": {
"command": "node",
"args": [
"clients/Gradio/mcp_servers/filesystem/dist/index.js",
"clients/Gradio/mcp_servers/filesystem/test"
]
},
"sqlite": {
"command": "uv",
"args": [
"--directory",
"clients/Gradio/mcp_servers/sqlite",
"run",
"mcp-server-sqlite",
"--db-path",
"test.db"
]
}
}
}
```
--------------------------------------------------------------------------------
/agents/MCP-Client/Python/messages/send_prompts.py:
--------------------------------------------------------------------------------
```python
# messages/prompts.py
from anyio.streams.memory import MemoryObjectReceiveStream, MemoryObjectSendStream
from .send_message import send_message
from .message_types.prompts_messages import PromptsListMessage
async def send_prompts_list(
read_stream: MemoryObjectReceiveStream,
write_stream: MemoryObjectSendStream,
) -> list:
"""Send a 'prompts/list' message and return the list of prompts."""
message = PromptsListMessage()
# send the message
response = await send_message(
read_stream=read_stream,
write_stream=write_stream,
message=message,
)
# return the result
return response.get("result", [])
```
--------------------------------------------------------------------------------
/clients/Gradio/messages/send_prompts.py:
--------------------------------------------------------------------------------
```python
# messages/prompts.py
from anyio.streams.memory import MemoryObjectReceiveStream, MemoryObjectSendStream
from .send_message import send_message
from .message_types.prompts_messages import PromptsListMessage
async def send_prompts_list(
read_stream: MemoryObjectReceiveStream,
write_stream: MemoryObjectSendStream,
) -> list:
"""Send a 'prompts/list' message and return the list of prompts."""
message = PromptsListMessage()
# send the message
response = await send_message(
read_stream=read_stream,
write_stream=write_stream,
message=message,
)
# return the result
return response.get("result", [])
```
--------------------------------------------------------------------------------
/jest.config.js:
--------------------------------------------------------------------------------
```javascript
/** @type {import('ts-jest').JestConfigWithTsJest} */
export default {
preset: 'ts-jest',
testEnvironment: 'node',
extensionsToTreatAsEsm: ['.ts'],
moduleNameMapper: {
'^(\\.{1,2}/.*)\\.js$': '$1',
},
transform: {
'^.+\\.tsx?$': [
'ts-jest',
{
useESM: true,
},
],
},
testMatch: [
'**/tests/**/*.test.ts'
],
collectCoverage: true,
coverageDirectory: 'coverage',
coveragePathIgnorePatterns: [
'/node_modules/',
'/tests/',
'/dist/'
],
verbose: true,
testTimeout: 30000,
setupFiles: ['dotenv/config'],
globals: {
'ts-jest': {
tsconfig: 'tsconfig.json',
useESM: true,
},
},
};
```
--------------------------------------------------------------------------------
/examples/sftp_upload_with_id/demo_upload.py:
--------------------------------------------------------------------------------
```python
from pathlib import Path
from clients.Gradio.Api import PrivateGPTAPI
from clients.Gradio.config import Config
config_file = Path.absolute(Path(__file__).parent / "config_ftp.json")
# Initialize configuration with required fields
config = Config(config_file=config_file, required_fields=["base_url"])
target_groups = ["PrivateGPT"] #make sure group(s) exist in PrivateGPT
pgpt = PrivateGPTAPI(config)
pgpt.upload_sftp("path_to_file.pdf")
documents = pgpt.get_sources_from_group(pgpt.ftp_subfolder)
first_document_id = documents[0]["sourceId"]
print(first_document_id)
pgpt.update_source(first_document_id, groups=target_groups)
print(pgpt.get_document_info(first_document_id))
```
--------------------------------------------------------------------------------
/agents/MCP-Client/Python/messages/send_resources.py:
--------------------------------------------------------------------------------
```python
# messages/send_resources.py
from anyio.streams.memory import MemoryObjectReceiveStream, MemoryObjectSendStream
from .send_message import send_message
from .message_types.resources_messages import ResourcesListMessage
async def send_resources_list(
read_stream: MemoryObjectReceiveStream,
write_stream: MemoryObjectSendStream,
) -> list:
"""Send a 'resources/list' message and return the list of resources."""
# create the message
message = ResourcesListMessage()
# send the message
response = await send_message(
read_stream=read_stream,
write_stream=write_stream,
message=message,
)
# return the result
return response.get("result", [])
```
--------------------------------------------------------------------------------
/clients/Gradio/messages/send_resources.py:
--------------------------------------------------------------------------------
```python
# messages/send_resources.py
from anyio.streams.memory import MemoryObjectReceiveStream, MemoryObjectSendStream
from .send_message import send_message
from .message_types.resources_messages import ResourcesListMessage
async def send_resources_list(
read_stream: MemoryObjectReceiveStream,
write_stream: MemoryObjectSendStream,
) -> list:
"""Send a 'resources/list' message and return the list of resources."""
# create the message
message = ResourcesListMessage()
# send the message
response = await send_message(
read_stream=read_stream,
write_stream=write_stream,
message=message,
)
# return the result
return response.get("result", [])
```
--------------------------------------------------------------------------------
/agents/MCP-Client/Python/messages/message_types/incrementing_id_message.py:
--------------------------------------------------------------------------------
```python
# messages/message_types/incrementing_id_message.py
from typing import ClassVar
from ...messages.message_types.json_rpc_message import JSONRPCMessage
class IncrementingIDMessage(JSONRPCMessage):
counter: ClassVar[int] = 0
@classmethod
def load_counter(cls, value: int):
cls.counter = value
@classmethod
def save_counter(cls) -> int:
return cls.counter
def __init__(self, prefix: str, method: str, start_id: int = None, **kwargs):
if start_id is not None:
type(self).counter = start_id
else:
type(self).counter += 1
message_id = f"{prefix}-{type(self).counter}"
super().__init__(method=method, id=message_id, **kwargs)
```
--------------------------------------------------------------------------------
/clients/C# .Net/2.0 mcp_chat/obj/Debug/net9.0/mcp_chat.GeneratedMSBuildEditorConfig.editorconfig:
--------------------------------------------------------------------------------
```
is_global = true
build_property.TargetFramework = net9.0
build_property.TargetPlatformMinVersion =
build_property.UsingMicrosoftNETSdkWeb =
build_property.ProjectTypeGuids =
build_property.InvariantGlobalization =
build_property.PlatformNeutralAssembly =
build_property.EnforceExtendedAnalyzerRules =
build_property._SupportedPlatformList = Linux,macOS,Windows
build_property.RootNamespace = mcp_chat
build_property.ProjectDir = c:\Users\uwuertz\Documents\GitHub\MCP-Server-for-MAS-Developments\clients\C# .Net\2.0 mcp_chat\
build_property.EnableComHosting =
build_property.EnableGeneratedComInterfaceComImportInterop =
build_property.EffectiveAnalysisLevelStyle = 9.0
build_property.EnableCodeStyleSeverity =
```
--------------------------------------------------------------------------------
/clients/Gradio/messages/message_types/incrementing_id_message.py:
--------------------------------------------------------------------------------
```python
# messages/message_types/incrementing_id_message.py
from typing import ClassVar
from ...messages.message_types.json_rpc_message import JSONRPCMessage
class IncrementingIDMessage(JSONRPCMessage):
counter: ClassVar[int] = 0
@classmethod
def load_counter(cls, value: int):
cls.counter = value
@classmethod
def save_counter(cls) -> int:
return cls.counter
def __init__(self, prefix: str, method: str, start_id: int = None, **kwargs):
if start_id is not None:
type(self).counter = start_id
else:
type(self).counter += 1
message_id = f"{prefix}-{type(self).counter}"
super().__init__(method=method, id=message_id, **kwargs)
```
--------------------------------------------------------------------------------
/clients/C# .Net/1.0 mcp_login/obj/Debug/net9.0/mcp_login.GeneratedMSBuildEditorConfig.editorconfig:
--------------------------------------------------------------------------------
```
is_global = true
build_property.TargetFramework = net9.0
build_property.TargetPlatformMinVersion =
build_property.UsingMicrosoftNETSdkWeb =
build_property.ProjectTypeGuids =
build_property.InvariantGlobalization =
build_property.PlatformNeutralAssembly =
build_property.EnforceExtendedAnalyzerRules =
build_property._SupportedPlatformList = Linux,macOS,Windows
build_property.RootNamespace = mcp_login
build_property.ProjectDir = c:\Users\uwuertz\Documents\GitHub\MCP-Server-for-MAS-Developments\clients\C# .Net\1.0 mcp_login\
build_property.EnableComHosting =
build_property.EnableGeneratedComInterfaceComImportInterop =
build_property.EffectiveAnalysisLevelStyle = 9.0
build_property.EnableCodeStyleSeverity =
```
--------------------------------------------------------------------------------
/clients/C# .Net/1.1 mcp_logout/obj/Debug/net9.0/mcp_logout.GeneratedMSBuildEditorConfig.editorconfig:
--------------------------------------------------------------------------------
```
is_global = true
build_property.TargetFramework = net9.0
build_property.TargetPlatformMinVersion =
build_property.UsingMicrosoftNETSdkWeb =
build_property.ProjectTypeGuids =
build_property.InvariantGlobalization =
build_property.PlatformNeutralAssembly =
build_property.EnforceExtendedAnalyzerRules =
build_property._SupportedPlatformList = Linux,macOS,Windows
build_property.RootNamespace = mcp_logout
build_property.ProjectDir = c:\Users\uwuertz\Documents\GitHub\MCP-Server-for-MAS-Developments\clients\C# .Net\1.1 mcp_logout\
build_property.EnableComHosting =
build_property.EnableGeneratedComInterfaceComImportInterop =
build_property.EffectiveAnalysisLevelStyle = 9.0
build_property.EnableCodeStyleSeverity =
```
--------------------------------------------------------------------------------
/agents/OpenAI_Compatible_API_Agent/Dockerfile:
--------------------------------------------------------------------------------
```dockerfile
# Use an official Python runtime as a parent image
FROM python:3.12
# Set the working directory in the container
WORKDIR ./
# Copy the requirements file into the container
COPY agents/OpenAI_Compatible_API_Agent/requirements.txt ./
# Install any needed packages specified in requirements.txt
RUN pip install --no-cache-dir -r requirements.txt
# Copy the rest of the application code into the container
COPY ./agents/OpenAI_Compatible_API_Agent/ ./agents/OpenAI_Compatible_API_Agent/
# Copy the AgentInterface code into the container
COPY ./agents/AgentInterface/ ./agents/AgentInterface/
# Define the command to run the application
CMD ["python", "-m", "agents.OpenAI_Compatible_API_Agent.Python.openai_compatible_api"]
```
--------------------------------------------------------------------------------
/clients/C# .Net/5.1 mcp_edit_user/obj/Debug/net9.0/mcp_edit_user.GeneratedMSBuildEditorConfig.editorconfig:
--------------------------------------------------------------------------------
```
is_global = true
build_property.TargetFramework = net9.0
build_property.TargetPlatformMinVersion =
build_property.UsingMicrosoftNETSdkWeb =
build_property.ProjectTypeGuids =
build_property.InvariantGlobalization =
build_property.PlatformNeutralAssembly =
build_property.EnforceExtendedAnalyzerRules =
build_property._SupportedPlatformList = Linux,macOS,Windows
build_property.RootNamespace = mcp_edit_user
build_property.ProjectDir = c:\Users\uwuertz\Documents\GitHub\MCP-Server-for-MAS-Developments\clients\C# .Net\5.1 mcp_edit_user\
build_property.EnableComHosting =
build_property.EnableGeneratedComInterfaceComImportInterop =
build_property.EffectiveAnalysisLevelStyle = 9.0
build_property.EnableCodeStyleSeverity =
```
--------------------------------------------------------------------------------
/clients/C# .Net/3.1 mcp_get_source/obj/Debug/net9.0/mcp_get_source.GeneratedMSBuildEditorConfig.editorconfig:
--------------------------------------------------------------------------------
```
is_global = true
build_property.TargetFramework = net9.0
build_property.TargetPlatformMinVersion =
build_property.UsingMicrosoftNETSdkWeb =
build_property.ProjectTypeGuids =
build_property.InvariantGlobalization =
build_property.PlatformNeutralAssembly =
build_property.EnforceExtendedAnalyzerRules =
build_property._SupportedPlatformList = Linux,macOS,Windows
build_property.RootNamespace = mcp_get_source
build_property.ProjectDir = c:\Users\uwuertz\Documents\GitHub\MCP-Server-for-MAS-Developments\clients\C# .Net\3.1 mcp_get_source\
build_property.EnableComHosting =
build_property.EnableGeneratedComInterfaceComImportInterop =
build_property.EffectiveAnalysisLevelStyle = 9.0
build_property.EnableCodeStyleSeverity =
```
--------------------------------------------------------------------------------
/clients/C# .Net/5.0 mcp_store_user/obj/Debug/net9.0/mcp_store_user.GeneratedMSBuildEditorConfig.editorconfig:
--------------------------------------------------------------------------------
```
is_global = true
build_property.TargetFramework = net9.0
build_property.TargetPlatformMinVersion =
build_property.UsingMicrosoftNETSdkWeb =
build_property.ProjectTypeGuids =
build_property.InvariantGlobalization =
build_property.PlatformNeutralAssembly =
build_property.EnforceExtendedAnalyzerRules =
build_property._SupportedPlatformList = Linux,macOS,Windows
build_property.RootNamespace = mcp_store_user
build_property.ProjectDir = c:\Users\uwuertz\Documents\GitHub\MCP-Server-for-MAS-Developments\clients\C# .Net\5.0 mcp_store_user\
build_property.EnableComHosting =
build_property.EnableGeneratedComInterfaceComImportInterop =
build_property.EffectiveAnalysisLevelStyle = 9.0
build_property.EnableCodeStyleSeverity =
```
--------------------------------------------------------------------------------
/clients/C# .Net/3.3 mcp_edit_source/obj/Debug/net9.0/mcp_edit_source.GeneratedMSBuildEditorConfig.editorconfig:
--------------------------------------------------------------------------------
```
is_global = true
build_property.TargetFramework = net9.0
build_property.TargetPlatformMinVersion =
build_property.UsingMicrosoftNETSdkWeb =
build_property.ProjectTypeGuids =
build_property.InvariantGlobalization =
build_property.PlatformNeutralAssembly =
build_property.EnforceExtendedAnalyzerRules =
build_property._SupportedPlatformList = Linux,macOS,Windows
build_property.RootNamespace = mcp_edit_source
build_property.ProjectDir = c:\Users\uwuertz\Documents\GitHub\MCP-Server-for-MAS-Developments\clients\C# .Net\3.3 mcp_edit_source\
build_property.EnableComHosting =
build_property.EnableGeneratedComInterfaceComImportInterop =
build_property.EffectiveAnalysisLevelStyle = 9.0
build_property.EnableCodeStyleSeverity =
```
--------------------------------------------------------------------------------
/clients/C# .Net/4.0 mcp_list_groups/obj/Debug/net9.0/mcp_list_groups.GeneratedMSBuildEditorConfig.editorconfig:
--------------------------------------------------------------------------------
```
is_global = true
build_property.TargetFramework = net9.0
build_property.TargetPlatformMinVersion =
build_property.UsingMicrosoftNETSdkWeb =
build_property.ProjectTypeGuids =
build_property.InvariantGlobalization =
build_property.PlatformNeutralAssembly =
build_property.EnforceExtendedAnalyzerRules =
build_property._SupportedPlatformList = Linux,macOS,Windows
build_property.RootNamespace = mcp_list_groups
build_property.ProjectDir = c:\Users\uwuertz\Documents\GitHub\MCP-Server-for-MAS-Developments\clients\C# .Net\4.0 mcp_list_groups\
build_property.EnableComHosting =
build_property.EnableGeneratedComInterfaceComImportInterop =
build_property.EffectiveAnalysisLevelStyle = 9.0
build_property.EnableCodeStyleSeverity =
```