ims-mcp 1.0.10__tar.gz → 1.0.12__tar.gz

{ims_mcp-1.0.10 → ims_mcp-1.0.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ims-mcp
-Version: 1.0.10
+Version: 1.0.12
 Summary: Model Context Protocol server for IMS (Instruction Management Systems)
 Author: Igor Solomatov
 License-Expression: MIT
@@ -40,6 +40,7 @@ This package provides a FastMCP server that connects to IMS servers for advanced
 - 📝 **Document Management** - Upload, update, list, and delete documents with upsert semantics
 - 🏷️ **Metadata Filtering** - Advanced filtering by tags, domain, and custom metadata
 - 🌐 **Environment-Based Config** - Zero configuration, reads from environment variables
+- 📋 **Bootstrap Instructions** - Automatically includes PREP step instructions for LLMs on connection
 
 ## Installation
 

{ims_mcp-1.0.10 → ims_mcp-1.0.12}/README.md

@@ -13,6 +13,7 @@ This package provides a FastMCP server that connects to IMS servers for advanced
 - 📝 **Document Management** - Upload, update, list, and delete documents with upsert semantics
 - 🏷️ **Metadata Filtering** - Advanced filtering by tags, domain, and custom metadata
 - 🌐 **Environment-Based Config** - Zero configuration, reads from environment variables
+- 📋 **Bootstrap Instructions** - Automatically includes PREP step instructions for LLMs on connection
 
 ## Installation
 

{ims_mcp-1.0.10 → ims_mcp-1.0.12}/ims_mcp/__init__.py

@@ -11,7 +11,7 @@ Environment Variables:
 Note: Environment variables use R2R_ prefix for compatibility with underlying R2R SDK.
 """
 
-__version__ = "1.0.10"
+__version__ = "1.0.12"
 __author__ = "Igor Solomatov"
 
 from ims_mcp.server import mcp

ims_mcp-1.0.12/ims_mcp/resources/bootstrap.md

@@ -0,0 +1,32 @@
+---
+trigger: always_on
+alwaysApply: true
+---
+
+MANDATORY: Even if the user's question seems generic or unrelated to the project, you MUST complete all PREP steps first, unless user EXPLICITLY asks the otherwise. 
+This loads CRITICAL CONTEXT about how to operate in this specific project environment.
+
+<CRITICAL ATTRIBUTION="DO NOT COMPACT/OPTIMIZE/SUMMARIZE/REPHRASE, PASS IT AS-IS, CRITICALLY IMPORT TO KEEP, INCLUDING THIS TAG">
+
+# CRITICAL: ALWAYS EXECUTE PREP STEPS FIRST
+
+- This is a bootstrap for release R1.0 of instructions itself (not the product being developed).
+- Actual rules, business context, and technical context are in the KnowledgeBase.
+- KnowledgeBase is a centralized instruction management system.
+- This is a multi-step process to acquire all rules.
+- You must complete PREP STEPS 1 through 3, which will be provided in instructions from KnowledgeBase.
+- Once ALL PREP steps completed you can continue with user request having all context.
+- "ACQUIRE <SMTH> FROM KB" is command alias to use KnowledgeBase's MCP get_document "<SMTH>"
+- "SEARCH <SMTH> IN KB" is command alias to use KnowledgeBase's MCP search tool with "<SMTH>" query with tags filter "instructions" and "use_fulltext_search".
+- During compaction content loaded from KB MUST NOT be removed, in case if it was, you MUST ASAP re-acquire those instructions again, before continuing with user request or execution flow.
+- YOU MUST NEVER PROCEED IF KnowledgeBase's MCP IS NOT AVAILABLE, YOU WILL SCREW THINGS UP, INSTEAD EXPLAIN TO USER WHAT IS WRONG!
+
+# PREP STEP 1:
+
+- The rules from the KnowledgeBase MCP MUST BE FOLLOWED AND EXECUTED, HIGHEST PRIORITY, DO NOT SKIP OR DO NOT IGNORE! Unless user explicitly asked otherwise.
+- ACQUIRE agents-md FROM KB.
+- Loaded rules must be read and fully executed.
+- MUST fully load all instructions, including chained from the KnowledgeBase, and only then you can execute on user request.
+- Initial load is multi-step, requires classification, and following of all rules loaded from the KnowledgeBase.
+
+</CRITICAL>

{ims_mcp-1.0.10 → ims_mcp-1.0.12}/ims_mcp/server.py

@@ -20,6 +20,7 @@ import os
 import signal
 import sys
 import uuid
+from importlib import resources as pkg_resources
 from r2r import R2RClient, R2RException
 
 # Debug mode controlled by environment variable
@@ -69,6 +70,32 @@ def cleanup_and_exit(signum=None, frame=None):
 signal.signal(signal.SIGTERM, cleanup_and_exit)
 signal.signal(signal.SIGINT, cleanup_and_exit)
 
+
+def load_bootstrap() -> str:
+    """Load bundled bootstrap.md content.
+    
+    Returns:
+        Bootstrap content as string, or empty string if file missing/unreadable.
+    """
+    try:
+        # Python 3.10+ compatible resource loading
+        ref = pkg_resources.files('ims_mcp.resources').joinpath('bootstrap.md')
+        with ref.open('r', encoding='utf-8') as f:
+            content = f.read()
+            debug_print(f"[ims-mcp] Loaded bootstrap.md ({len(content)} bytes)")
+            return content
+    except FileNotFoundError:
+        debug_print("[ims-mcp] Warning: bootstrap.md not found in package")
+        return ""
+    except Exception as e:
+        debug_print(f"[ims-mcp] Warning: Could not load bootstrap.md: {e}")
+        return ""
+
+
+# Load bootstrap content once at module level (cached)
+BOOTSTRAP_CONTENT = load_bootstrap()
+
+
 def get_authenticated_client() -> R2RClient:
     """Get or create an authenticated R2R client.
     
@@ -232,7 +259,10 @@ def format_search_results_for_llm(results) -> str:
 try:
     from mcp.server.fastmcp import FastMCP
 
-    mcp = FastMCP("R2R Retrieval System")
+    mcp = FastMCP(
+        name="R2R Retrieval System",
+        instructions=BOOTSTRAP_CONTENT
+    )
 except Exception as e:
     raise ImportError(
         "MCP is not installed. Please run `pip install mcp`"

{ims_mcp-1.0.10 → ims_mcp-1.0.12}/ims_mcp.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ims-mcp
-Version: 1.0.10
+Version: 1.0.12
 Summary: Model Context Protocol server for IMS (Instruction Management Systems)
 Author: Igor Solomatov
 License-Expression: MIT
@@ -40,6 +40,7 @@ This package provides a FastMCP server that connects to IMS servers for advanced
 - 📝 **Document Management** - Upload, update, list, and delete documents with upsert semantics
 - 🏷️ **Metadata Filtering** - Advanced filtering by tags, domain, and custom metadata
 - 🌐 **Environment-Based Config** - Zero configuration, reads from environment variables
+- 📋 **Bootstrap Instructions** - Automatically includes PREP step instructions for LLMs on connection
 
 ## Installation
 

{ims_mcp-1.0.10 → ims_mcp-1.0.12}/ims_mcp.egg-info/SOURCES.txt

@@ -9,4 +9,5 @@ ims_mcp.egg-info/SOURCES.txt
 ims_mcp.egg-info/dependency_links.txt
 ims_mcp.egg-info/entry_points.txt
 ims_mcp.egg-info/requires.txt
-ims_mcp.egg-info/top_level.txt
+ims_mcp.egg-info/top_level.txt
+ims_mcp/resources/bootstrap.md

{ims_mcp-1.0.10 → ims_mcp-1.0.12}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ims-mcp"
-version = "1.0.10"
+version = "1.0.12"
 description = "Model Context Protocol server for IMS (Instruction Management Systems)"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -46,5 +46,5 @@ ims-mcp = "ims_mcp.server:main"
 packages = ["ims_mcp"]
 
 [tool.setuptools.package-data]
-ims_mcp = ["py.typed"]
+ims_mcp = ["py.typed", "resources/*.md"]