Innovaas KMS MCP Server
OfficialIntegrates with OpenAI's GPT-4o-mini for chat responses and embeddings, enabling RAG-powered knowledge queries with intelligent token management.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Innovaas KMS MCP Server What are best practices for implementing a Unified Namespace?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
π§ Innovaas KMS MCP Server
Enhanced Model Context Protocol (MCP) server for the Innovaas RAG Knowledge Management System. This server exposes powerful multi-modal search, RAG-powered chat with intelligent token management, and comprehensive document access to external systems via the standardized MCP protocol.
β‘ Latest v1.0.0 Features
π― Intelligent Token Management
Automatic Optimization: Prevents API token limit errors (65K+ β 30K tokens)
Provider-Aware: Different limits for OpenAI (30K) vs Claude (200K)
Smart Document Selection: Prioritizes by relevance, includes summaries of excluded content
Zero Configuration: Works automatically with
kms_chattool
π Advanced Search Capabilities
Full Document Content: Complete text (4,000+ characters) instead of 200-char previews
Multi-Modal Search: Text, audio transcriptions, video frames, and technical content
Intelligent Routing: Enhanced RAG with query analysis and optimal strategy selection
Technical Content Detection: Find code, diagrams, and UI elements in video content
π¬ Enhanced RAG-Powered Chat
Comprehensive Responses: Based on complete source material with full content access
Source Citations: Precise document and timestamp references
Provider Choice: OpenAI GPT-4o-mini or Claude for different use cases
Context Filtering: Focus conversations by tags and document types
Related MCP server: mcp-business-bot
π Quick Start
1. Installation
# Clone the repository
git clone https://github.com/innovaas/kms-mcp-server.git
cd kms-mcp-server
# Install dependencies
npm install
# Build the server
npm run build2. Configuration
# Required: KMS API endpoint
export KMS_BASE_URL="https://your-kms-domain.com/kms"
# Required: Authentication key
export BACKGROUND_PROCESS_API_KEY="your-secure-api-key"
# OR use MCP-specific key
export MCP_API_KEY="your-mcp-api-key"3. Run the Server
# Development mode
npm run dev
# Production mode
npm start
# With environment variables inline
KMS_BASE_URL="https://your-domain.com/kms" BACKGROUND_PROCESS_API_KEY="your-key" npm startπ οΈ Integration Examples
Claude Desktop Configuration
Add to your Claude Desktop config file (~/.claude_desktop_config.json):
{
"mcpServers": {
"innovaas-kms": {
"command": "node",
"args": ["/path/to/kms-mcp-server/dist/index.js"],
"env": {
"KMS_BASE_URL": "https://your-domain.com/kms",
"BACKGROUND_PROCESS_API_KEY": "your-secure-api-key"
}
}
}
}Cline/VSCode Integration
Configure in your MCP settings:
{
"name": "innovaas-kms",
"serverPath": "/path/to/kms-mcp-server/dist/index.js",
"environment": {
"KMS_BASE_URL": "https://your-domain.com/kms",
"MCP_API_KEY": "your-secure-api-key"
}
}Programmatic Integration
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
const transport = new StdioClientTransport({
command: "node",
args: ["/path/to/kms-mcp-server/dist/index.js"],
env: {
KMS_BASE_URL: "https://your-domain.com/kms",
MCP_API_KEY: "your-api-key"
}
});
const client = new Client(
{ name: "kms-client", version: "1.0.0" },
{ capabilities: {} }
);
await client.connect(transport);
// Use intelligent search with full content
const result = await client.callTool({
name: "kms_intelligent_search",
arguments: {
query: "What are the best practices for implementing a Unified Namespace?",
maxResults: 10
}
});π― Available Tools
kms_chat π Primary Tool
Comprehensive knowledge queries with intelligent token management
{
"message": "How do I implement OEE monitoring in a manufacturing environment?",
"provider": "openai",
"useMultiModal": true,
"tags": ["OEE", "manufacturing"],
"maxResults": 15
}β Key Benefits:
Token Optimization: Automatically prevents API limit errors
Full Content Access: Complete document text (4,000+ characters)
Provider-Aware: Adjusts context size for OpenAI vs Claude
Multi-Modal Context: Combines text, video, and web sources
kms_intelligent_search
Advanced RAG search with query analysis
{
"query": "unified namespace MQTT implementation patterns",
"maxResults": 15,
"filters": {
"type": "video",
"tags": ["UNS", "MQTT"]
},
"includeAnalysis": true
}kms_multimodal_search
Search across all content types
{
"query": "user authentication flow diagrams",
"searchMode": "multimodal",
"maxResults": 10,
"filters": {
"hasVisualContent": true,
"documentTypes": ["video", "whitepaper"]
}
}kms_search
Basic semantic search
{
"query": "manufacturing execution systems",
"limit": 10,
"threshold": 0.7
}kms_get_document
Retrieve specific document
{
"documentId": "uuid-of-document"
}kms_get_stats
System analytics
{
"includeProcessingDetails": true
}kms_list_documents
Browse documents
{
"limit": 25,
"type": "video",
"tags": ["training", "technical"],
"mediaType": "video"
}π What's Fixed in v1.0.0
β Before: Token Limit Errors
Error: Request too large for gpt-4o: Limit 30000, Requested 70239β After: Intelligent Optimization
{
"tokenOptimization": {
"enabled": true,
"documentsIncluded": 8,
"documentsExcluded": 7,
"optimization": "Included 8/15 documents, using ~27,518 tokens",
"estimatedTotalTokens": 27518
}
}π§ Improvements Made
Automatic Token Management: No more API limit errors
Smart Document Selection: Prioritizes most relevant content
Full Content Access: 4,000+ character responses vs 200-char previews
Provider Optimization: Different strategies for OpenAI vs Claude
Transparent Operation: Shows what was included/excluded and why
π System Capabilities
Current KMS Status β
127+ documents processed with 100% success rate
1,000+ video frames extracted and analyzed
Multi-modal search across text, audio, and video
Technical content detection for code, diagrams, UI elements
Real-time processing pipeline with error recovery
Content Coverage
Technical Documentation: API docs, system architecture, code examples
Training Videos: 105+ processed videos with transcription and frame analysis
Manufacturing Content: MES, OEE, UNS, MQTT, IoT, SCADA terminology
Web Resources: Crawled documentation and technical resources
AI Capabilities
AssemblyAI: High-quality transcription with technical term boosting
OpenAI Embeddings: 1536-dimensional vectors for semantic search
Claude Vision: Technical content analysis for diagrams and code
Multi-Provider Chat: OpenAI GPT-4o-mini and Claude support
π‘οΈ Authentication & Security
API Key Authentication
# Set authentication key
export BACKGROUND_PROCESS_API_KEY="secure-random-string"
# Or use MCP-specific key
export MCP_API_KEY="mcp-specific-secure-key"Network Configuration
Protocol: HTTPS (secure connection)
Transport: STDIO (standard for MCP)
Authentication: Bearer token with API key
π Development
Project Structure
kms-mcp-server/
βββ src/
β βββ index.ts # Main MCP server implementation
βββ dist/ # Built files (generated by npm run build)
βββ examples/ # Configuration examples
βββ package.json # Dependencies and scripts
βββ tsconfig.json # TypeScript configuration
βββ README.md # This fileScripts
npm run build # Compile TypeScript to JavaScript
npm run dev # Development mode with hot reload
npm start # Run compiled server
npm run clean # Clean build directory
npm test # Run testsRequirements
Node.js: 18.0.0 or higher
TypeScript: 5.0.0 or higher
KMS Server: Running Innovaas KMS instance
π Troubleshooting
Common Issues
Connection Failed
Error: KMS API request failed: 500 Internal Server Errorβ Ensure KMS server is running
β Check
KMS_BASE_URLenvironment variableβ Verify network connectivity
Authentication Errors
Error: 401 Unauthorizedβ Verify API key is set correctly
β Check Bearer token format
β Ensure KMS server has matching API key
Token Limit Errors (Should be fixed)
Error: Request too large for gpt-4o: Limit 30000, Requested 65879β Update to v1.0.0 with token optimization
β Use
kms_chattool (automatically optimized)β Check
tokenOptimizationin responses
Debug Mode
# Enable verbose logging
DEBUG=1 npm run dev
# Check KMS server status
curl -H "Authorization: Bearer your-api-key" https://your-domain.com/kms/api/dashboard-statsπ€ Contributing
Fork the repository
Create a feature branch:
git checkout -b feature/amazing-featureMake your changes
Run tests:
npm testBuild:
npm run buildCommit changes:
git commit -m 'Add amazing feature'Push to branch:
git push origin feature/amazing-featureCreate Pull Request
Development Guidelines
Follow existing code patterns for consistency
Add comprehensive error handling
Update tool schemas when modifying parameters
Test with multiple MCP clients before committing
Document new features in README
π License
MIT License - see the LICENSE file for details.
π Links
GitHub Repository: https://github.com/innovaas/kms-mcp-server
Innovaas Website: https://innovaas.co
Model Context Protocol: https://modelcontextprotocol.io
π Ready to integrate your knowledge management with any MCP-compatible system with intelligent token optimization!
Available Tools
7 toolskms_chatC
π Primary tool for comprehensive knowledge queries. RAG-powered conversational queries with multi-modal context, intelligent token management, and full document content access. Automatically optimizes for token limits while providing comprehensive responses.
Inputs: message (required), tags, types, provider, +2 more.
kms_get_documentA
Retrieve detailed information about a specific document by ID, including full content, transcriptions, and metadata.
Inputs: documentId (required).
kms_get_statsB
Get comprehensive analytics and statistics about the KMS system including document counts, processing status, and performance metrics.
Inputs: includeProcessingDetails.
kms_intelligent_searchC
Advanced RAG search with intelligent query analysis, routing, and full content access. Uses enhanced middleware for optimal search strategy selection.
Inputs: query (required), filters, maxResults, includeAnalysis.
kms_list_documentsB
List recent documents with filtering options. Useful for browsing and discovering content in the knowledge base.
Inputs: tags, type, limit, mediaType.
kms_multimodal_searchB
Enhanced multi-modal search with full content retrieval. Search across text, audio, video content and video frames with technical content detection (code, diagrams, UI elements).
Inputs: query (required), filters, maxResults, searchMode.
kms_searchC
Semantic search across documents using vector similarity. Searches through text documents, audio transcriptions, and video content with full document content retrieval.
Inputs: query (required), limit, threshold.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 7 tools
Four search tools (kms_search, kms_intelligent_search, kms_multimodal_search, kms_chat) have overlapping purposes and unclear boundaries. An agent cannot reliably choose among them without deep understanding of the server's internals.
All tool names follow a consistent kms_verb_noun pattern (kms_search, kms_get_document, kms_list_documents). This is predictable and easy to parse.
Seven tools is a reasonable count for a knowledge management server. However, the redundancy among search tools suggests some could be merged or better differentiated.
The server covers search, retrieval, chat, and stats, but lacks any write operations (create, update, delete documents). This is a notable gap for a KMS, though read-only functionality might be intentional.
Maintenance
Related MCP Connectors
Knowledge base MCP for AI agents on iknow.dev. Search, read, and maintain via OAuth.
Search and manage your team's knowledge from MCP clients.
Make your knowledge agent-ready. One MCP endpoint, 5 connectors, 3 search modes.
Authenticated MCP access to the AIKI open knowledge commons.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables document-based Q&A with multi-modal RAG, hybrid retrieval, knowledge graph reasoning, and multi-agent orchestration via MCP tools.4MIT
- FlicenseNot gradedqualityDmaintenanceEnables querying company knowledge base using RAG, providing accurate answers from internal documents via MCP.-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to query and manage a document knowledge base via MCP, with RAG-powered search and grounded answers with citations.MIT
- AlicenseNot gradedqualityDmaintenanceProvides enterprise knowledge management capabilities via MCP, enabling semantic search across the knowledge base, retrieval of full documents by ID, and search over enterprise project cases.MIT