sokrates-mcp 0.4.1__py3-none-any.whl → 0.4.2__py3-none-any.whl

sokrates_mcp/main.py

@@ -9,94 +9,7 @@
 # through various prompt engineering workflows. It provides APIs for refining prompts, executing them externally,
 # breaking down complex tasks, generating ideas, performing code reviews, and listing available models/providers.
 #
-# Parameters
-# - `refine_prompt`: Refines a given prompt by enriching it with additional context.
-#   - `prompt` (str): The input prompt to be refined.
-#   - `refinement_type` (str, optional): Type of refinement ('code' or 'default'). Default is 'default'.
-#   - `provider` (str, optional): Name of the provider to use for refinement. Default is 'default'.
-#   - `model` (str, optional): Model name for refinement. Default is 'default'.
 #
-# - `refine_and_execute_external_prompt`: Refines a prompt and executes it with an external LLM.
-#   - `prompt` (str): The input prompt to be refined and executed.
-#   - `provider` (str, optional): Name of the provider to use for LLM interactions. Default is 'default'.
-#   - `refinement_model` (str, optional): Model for refinement. Default is 'default'.
-#   - `execution_model` (str, optional): Model for execution. Default is 'default'.
-#   - `refinement_type` (str, optional): Type of refinement ('code' or 'default'). Default is 'default'.
-#
-# - `handover_prompt`: Hands over a prompt to an external LLM for processing.
-#   - `prompt` (str): The prompt to be executed externally.
-#   - `provider` (str, optional): Name of the provider to use for LLM interactions. Default is 'default'.
-#   - `model` (str, optional): Model name for execution. Default is 'default'.
-#   - `temperature` (float, optional): Temperature for the external execution. Default is 0.7.
-#
-# - `breakdown_task`: Breaks down a task into sub-tasks with complexity ratings.
-#   - `task` (str): The full task description to break down.
-#   - `provider` (str, optional): Name of the provider to use for LLM interactions. Default is 'default'.
-#   - `model` (str, optional): Model name for processing. Default is 'default'.
-#
-# - `generate_random_ideas`: Generates random ideas on a random topic.
-#   - `idea_count` (int, optional): Number of ideas to generate. Default is 1.
-#   - `provider` (str, optional): Name of the provider to use for LLM interactions. Default is 'default'.
-#   - `model` (str, optional): Model name for generation. Default is 'default'.
-#   - `temperature` (float, optional): Temperature for idea generation. Default is 0.7.
-#
-# - `generate_ideas_on_topic`: Generates ideas on a specific topic.
-#   - `topic` (str): The topic to generate ideas for.
-#   - `provider` (str, optional): Name of the provider to use for LLM interactions. Default is 'default'.
-#   - `model` (str, optional): Model name for generation. Default is 'default'.
-#   - `idea_count` (int, optional): Number of ideas to generate. Default is 1.
-#   - `temperature` (float, optional): Temperature for idea generation. Default is 0.7.
-#
-# - `generate_code_review`: Generates a code review in markdown format.
-#   - `source_file_paths` (list): List of source file paths to be reviewed.
-#   - `target_directory` (str): Directory to store the resulting review files.
-#   - `provider` (str, optional): Name of the provider to use for LLM interactions. Default is 'default'.
-#   - `model` (str, optional): Model name for code review generation. Default is 'default'.
-#   - `review_type` (str, optional): Type of review ('style', 'security', 'performance', 'quality'). Default is 'quality'.
-#
-# - `list_available_models_for_provider`: Lists all available large language models for a specific provider.
-#   - `provider_name` (str, optional): Name of the provider to list models for. Default is empty (uses default).
-#
-# - `list_available_providers`: Lists all configured and available API providers.
-#
-# Usage Examples
-# ```python
-# Refine a prompt
-# await refine_prompt("Write a Python function to sort a list", refinement_type="code")
-#
-# # Refine and execute a prompt with an external LLM
-# await refine_and_execute_external_prompt(
-#     "Generate a summary of the following text: ...",
-#     refinement_model="model1",
-#     execution_model="model2"
-# )
-#
-# # Hand over a prompt to an external LLM
-# await handover_prompt("Translate this text to French: ...")
-#
-# # Break down a task into sub-tasks
-# await breakdown_task("Implement user authentication system")
-#
-# # Generate random ideas
-# await generate_random_ideas(idea_count=3)
-#
-# # Generate ideas on a topic
-# await generate_ideas_on_topic("AI in healthcare", idea_count=5)
-#
-# # Generate code review
-# await generate_code_review(
-#     source_file_paths=["/path/to/file1.py", "/path/to/file2.py"],
-#     target_directory="/path/to/reviews"
-# )
-#
-# # List available models for a provider
-# await list_available_models_for_provider("my-provider")
-#
-# # List all available providers
-# await list_available_providers()
-# ```
-#
-
 from typing import Annotated, Optional
 from pydantic import Field
 from .mcp_config import MCPConfig
@@ -107,7 +20,7 @@ import os
 import argparse
 
 MCP_NAME = "sokrates-mcp"
-VERSION = "0.2.0"
+VERSION = "0.4.2"
 DEFAULT_PROVIDER_IDENTIFIER = "default"
 DEFAULT_MODEL_IDENTIFIER = "default"
 DEFAULT_REFINEMENT_TYPE = "default"
@@ -252,7 +165,7 @@ async def breakdown_task(task: Annotated[str, Field(description="The full task d
 
 @mcp.tool(
     name="generate_random_ideas",
-    description="Invents and generates a random topic an generates the provided count of ideas on the topic.",
+    description="Invents and generates a random topic and generates the provided count of ideas on the topic.",
     tags={"idea", "generator","invention","random"}
 )
 async def generate_random_ideas(ctx: Context,
@@ -286,7 +199,7 @@ async def generate_ideas_on_topic(
 async def generate_code_review(
     ctx: Context,
     source_directory: Annotated[str, Field(description="The absolute directory path containing source files to create reviews for. This should contain source files on the local filesystem.")],
-    source_file_paths: Annotated[list, Field(description="A list of absolute source file paths that should be reviewed. The paths should be absolute paths in the local filesystem.")],
+    source_file_paths: Annotated[list[str], Field(description="A list of absolute source file paths that should be reviewed. The paths should be absolute paths in the local filesystem.")],
     target_directory: Annotated[str, Field(description="The directory to store the resulting review markdown files. This should point to the desired target path for the markdown files on the local filesystem.")],
     provider: Annotated[str, Field(description="The name of the provider to use for LLM interactions. The default model name is 'default', which will pick the server's default provider configured.", default=DEFAULT_PROVIDER_IDENTIFIER)],
     model: Annotated[str, Field(description="[Optional] The name of the model that should be used for the generation. The default model name is 'default', which will pick the server's default model.", default=DEFAULT_MODEL_IDENTIFIER)],

sokrates_mcp/mcp_config.py

@@ -8,7 +8,6 @@
 # - api_endpoint: API endpoint URL (default: http://localhost:1234/v1)
 # - api_key: API key for authentication (default: mykey)
 # - model: Model name to use (default: qwen/qwen3-4b-2507)
-# - verbose: Enable verbose logging (default: False)
 #
 # Usage example:
 #   config = MCPConfig(api_endpoint="https://api.example.com", model="my-model")
@@ -54,7 +53,7 @@ class MCPConfig:
         "openai"
     ]
     
-    def __init__(self, config_file_path: str = CONFIG_FILE_PATH, api_endpoint: str = DEFAULT_API_ENDPOINT, api_key: str = DEFAULT_API_KEY, model: str = DEFAULT_MODEL, verbose: bool = False):
+    def __init__(self, config_file_path: str = CONFIG_FILE_PATH, api_endpoint: str = DEFAULT_API_ENDPOINT, api_key: str = DEFAULT_API_KEY, model: str = DEFAULT_MODEL):
         """Initialize MCP configuration.
 
         Args:
@@ -63,11 +62,9 @@ class MCPConfig:
             api_endpoint (str): API endpoint URL. Defaults to DEFAULT_API_ENDPOINT.
             api_key (str): API key for authentication. Defaults to DEFAULT_API_KEY.
             model (str): Model name to use. Defaults to DEFAULT_MODEL.
-            verbose (bool): Enable verbose logging. Defaults to False.
 
         Side Effects:
             Initializes instance attributes with values from config file or defaults
-            Sets up logging based on verbose parameter
         """
         self.logger = logging.getLogger(__name__)
         self.config_file_path = config_file_path

sokrates_mcp/workflow.py

@@ -10,7 +10,25 @@ from sokrates.coding.code_review_workflow import run_code_review
 from .mcp_config import MCPConfig
 from .utils import Utils
 
+"""Workflow module for Sokrates MCP server.
+
+This module implements the :class:`Workflow` class which encapsulates
+all business logic exposed as FastMCP tools.  It relies on a validated
+:class:`~sokrates_mcp.mcp_config.MCPConfig` instance and uses the
+`sokrates` library to interact with LLM providers.
+"""
+
+"""Workflow module for Sokrates MCP server.
+
+This module implements the :class:`Workflow` class which encapsulates
+all business logic exposed as FastMCP tools.  It relies on a validated
+:class:`~sokrates_mcp.mcp_config.MCPConfig` instance and uses the
+`sokrates` library to interact with LLM providers.
+"""
+
 class Workflow:
+
+
   
   WORKFLOW_COMPLETION_MESSAGE = "Workflow completed."
   

{sokrates_mcp-0.4.1.dist-info → sokrates_mcp-0.4.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sokrates-mcp
-Version: 0.4.1
+Version: 0.4.2
 Summary: A templated MCP server for demonstration and quick start.
 Author-email: Julian Weber <julianweberdev@gmail.com>
 License: MIT License
@@ -39,7 +39,7 @@ Dynamic: license-file
 # sokrates-mcp
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-[![Version: 0.4.1](https://img.shields.io/badge/version-0.4.1-green)](https://github.com/Kubementat/sokrates-mcp)
+[![Version: 0.4.2](https://img.shields.io/badge/version-0.4.2-green)](https://github.com/Kubementat/sokrates-mcp)
 
 A MCP server offering tools for prompt refinement and execution workflows using the FastMCP framework and the `sokrates` python library.
 
@@ -214,6 +214,9 @@ If you see "ModuleNotFoundError: fastmcp", ensure:
 
 ## Changelog
 
+**0.4.2 (Sep 2025)**
+- Update version to 0.4.2
+
 **0.4.1 (Sep 2025)**
 - fix roll_dice tool
 

sokrates_mcp-0.4.2.dist-info/RECORD

@@ -0,0 +1,13 @@
+sokrates_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sokrates_mcp/main.py,sha256=pgzEnMAkCv9nS9JJ-ZRh_oigvTNBhel87WqAWgvpsEM,19308
+sokrates_mcp/mcp_config.py,sha256=0dvxg5Uyug_-P0UL97ahKrhHmP5A2HyNP7_FMy3aWy0,12193
+sokrates_mcp/utils.py,sha256=LOXRXjuEVhqVjJeJ7Rnn7eAVwzZEbWz7Vn9pwVb9oac,795
+sokrates_mcp/workflow.py,sha256=IF9G6U7RicLLfclnSFiOFt5JWDq1NvpoSMT-6rbzGA4,18273
+sokrates_mcp-0.4.2.dist-info/licenses/LICENSE,sha256=OgJ7nuNhaIefjDRK0wTGOErJ_c1984Eg9oUweycmal0,1068
+sokrates_mcp_client/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sokrates_mcp_client/mcp_client_example.py,sha256=L5_xH0u7lt0k0t_eiFFhN9FVU__seFhxHfRixdy14PU,3866
+sokrates_mcp-0.4.2.dist-info/METADATA,sha256=aWHURgbD6mCAym1gTO1Dw-fDIjWiFtZiRVHy_OrlM9s,6720
+sokrates_mcp-0.4.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+sokrates_mcp-0.4.2.dist-info/entry_points.txt,sha256=7gYOgoyRs_mE6dmwMJrAtrMns2mxv4ZbqXBznRh3sUc,56
+sokrates_mcp-0.4.2.dist-info/top_level.txt,sha256=Nbwxz5Mm6LVkglOxqt4ZyEO5A6D4VjjN8c6d-fQyc3k,33
+sokrates_mcp-0.4.2.dist-info/RECORD,,

sokrates_mcp-0.4.1.dist-info/RECORD

@@ -1,13 +0,0 @@
-sokrates_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sokrates_mcp/main.py,sha256=Mm9DcviqzZgoZphKO0mqgPtc2vqNaLQKqU_CVw5OkEI,23883
-sokrates_mcp/mcp_config.py,sha256=5MnKhmZTCUhZQwhq1mlxuZwaAyC7Sw9VkMZ-DfMACoM,12395
-sokrates_mcp/utils.py,sha256=LOXRXjuEVhqVjJeJ7Rnn7eAVwzZEbWz7Vn9pwVb9oac,795
-sokrates_mcp/workflow.py,sha256=HxDIIabrinT2E6aSNELP2jAKKXdMkipbUO4y5jqQqoo,17655
-sokrates_mcp-0.4.1.dist-info/licenses/LICENSE,sha256=OgJ7nuNhaIefjDRK0wTGOErJ_c1984Eg9oUweycmal0,1068
-sokrates_mcp_client/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sokrates_mcp_client/mcp_client_example.py,sha256=L5_xH0u7lt0k0t_eiFFhN9FVU__seFhxHfRixdy14PU,3866
-sokrates_mcp-0.4.1.dist-info/METADATA,sha256=3q4Ena0hIzli-_MEHVLzxVpl6RLhoUu1dav83ZoiZV0,6672
-sokrates_mcp-0.4.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-sokrates_mcp-0.4.1.dist-info/entry_points.txt,sha256=7gYOgoyRs_mE6dmwMJrAtrMns2mxv4ZbqXBznRh3sUc,56
-sokrates_mcp-0.4.1.dist-info/top_level.txt,sha256=Nbwxz5Mm6LVkglOxqt4ZyEO5A6D4VjjN8c6d-fQyc3k,33
-sokrates_mcp-0.4.1.dist-info/RECORD,,