keywordgraph-mcp-server 1.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 InfraNodus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,629 @@
+# KeywordGraph MCP Server
+
+A Model Context Protocol (MCP) server that integrates KeywordGraph knowledge graph and text network analysis capabilities into LLM workflows and AI assistants like Claude Desktop.
+
+## Overview
+
+KeywordGraph MCP Server enables LLM workflows and AI assistants to analyze text using advanced network science algorithms, generate knowledge graphs, detect content gaps, and identify key topics and concepts. It transforms unstructured text into structured insights using graph theory and network analysis.
+
+![KeywordGraph MCP Server](https://keywordgraph.com/images/front/keywordgraph-overview.jpg)
+
+## Features
+
+### You Can Use It To
+
+- Connect your existing KeywordGraph knowledge graphs to your LLM workflows and AI chats
+- Identify the main topical clusters in discourse without missing the important nuances (works better than standard LLM workflows)
+- Identify the content gaps in any discourse (helpful for content creation and research)
+- Generate new knowledge graphs from any text and use them to augment your LLM responses
+- Save and retrieve entities and relations from memory using the knowledge graphs
+
+### Available Tools
+
+1. **generate_knowledge_graph**
+   - Convert any text into a visual knowledge graph
+   - Extract topics, concepts, and their relationships
+   - Identify structural patterns and clusters
+   - Apply AI-powered topic naming
+   - Perform entity detection for cleaner graphs
+
+2. **analyze_existing_graph_by_name**
+   - Retrieve and analyze existing graphs from your KeywordGraph account
+   - Access previously saved analyses
+   - Export graph data with full statistics
+
+3. **analyze_text**
+   - Analyze a text, URL, or YouTube transcript
+   - Extract and analyze a graph from text or URL; provide either text or url
+   - Get topics, clusters, statements, graph structure, and AI summary as requested
+
+4. **generate_content_gaps**
+   - Detect missing connections in discourse
+   - Identify underexplored topics
+   - Generate research questions
+   - Suggest content development opportunities
+
+5. **generate_topical_clusters**
+   - Generate topics and clusters of keywords from text using knowledge graph analysis
+   - Make sure to beyond genetic insights and detect smaller topics
+   - Use the topical clusters to establish topical authority for SEO
+   - Returns AI-generated overviews of the topical clusters (`topicalClusterSummaries`), summarizing the discourse each cluster represents — useful for SEO-optimized content creation. Enabled by default; set `generateTopicalSummaries: false` to increase processing speed or if the summary request fails
+
+6. **generate_contextual_hint**
+   - Generate a topical overview of a text and provide insights for LLMs to generate better responses
+   - Use it to get a high-level understanding of a text
+   - Use it to augment prompts in your LLM workflows and AI assistants
+
+7. **generate_research_questions**
+   - Generate research questions that bridge content gaps from text, URL, or an existing KeywordGraph graph
+   - Use them as prompts in your LLM models and AI workflows
+   - Use any AI model (included in KeywordGraph API)
+   - Content gaps are identified based on topical clustering
+
+8. **generate_research_ideas**
+   - Generate innovative research ideas based on content gaps identified in the text
+   - Get actionable ideas to improve the text and develop the discourse
+   - Use any AI model (included in KeywordGraph API)
+   - Ideas are generated from gaps between topical clusters
+
+9. **optimize_text_structure**
+   - Analyze the level of bias and coherence in text using knowledge graph analysis
+   - If the text is too biased, develop the represented topics to balance the discourse
+   - If the text is focused or diversified, develop the content gaps to deepen the analysis
+   - If the text is dispersed, focus the most common gap topics to improve coherence
+   - Choose response type: response, idea, question, or transcend
+
+10. **generate_responses_from_graph**
+    - Generate responses based on an existing KeywordGraph graph
+    - Integrate them into your LLM workflows and AI assistants
+    - Use any AI model (included in KeywordGraph API)
+    - Use any prompt
+
+11. **develop_conceptual_bridges**
+    - Analyze text and develop latent ideas based on concepts that connect this text to a broader discourse
+    - Discover hidden themes and patterns that link your text to wider contexts
+    - Use any AI model (included in KeywordGraph API)
+    - Generate insights that help develop the discourse
+
+12. **develop_latent_topics**
+    - Analyze text and extract underdeveloped topics with ideas on how to develop them
+    - Identify topics that need more attention and elaboration
+    - Use any AI model (included in KeywordGraph API)
+    - Get actionable suggestions for content expansion
+
+13. **develop_text_tool**
+    - Comprehensive text analysis combining content gap ideas, latent topics, and conceptual bridges
+    - Executes multiple analyses in sequence with progress tracking
+    - Generates research ideas based on content gaps
+    - Identifies latent topics and conceptual bridges to develop
+    - Finds content gaps for deeper exploration
+
+14. **create_knowledge_graph**
+    - Create a knowledge graph in KeywordGraph from text and provide a link to it
+    - Use it to create a knowledge graph in KeywordGraph from text
+
+15. **generate_ontology_graph**
+    - Use AI to generate a reasoning ontology graph (entities and the relations between them) from a topic, prompt, or text — e.g. "build an ontology on AI attention mechanisms"
+    - Saved as a persistent KeywordGraph graph by default and a link is returned; set `saveGraph: false` if the user asks not to save, or when you only need a one-off AI ontology overview of a topic for the current context that won't be reused later (the generated statements are returned directly without persisting)
+    - `modelToUse` defaults to `claude-opus-4.6` for richer ontologies; pick `-mini`/`-lite` variants (or `gpt-4o-mini`) for faster, cheaper generation
+    - Returns the compact graph structure (`knowledgeGraph`) and analytics (main topical clusters, content gaps, top influential nodes, top relations, statistics) by default. Set `includeGraph: false` to save context space when only the ontology statements or insights are needed. Set `includeAnalytics: false` if you just need the raw ontology without graph-derived insights — keep it on whenever you want to understand the structure, gaps, or key concepts
+
+16. **analyze_llm_results**
+    - Ask an LLM to describe a topic and turn its response into a knowledge graph that reveals how the model frames it — main concepts, clusters, content gaps, and the relations between them
+    - Use it to probe model bias, surface the implicit structure of an LLM's view on a subject, or compare how different models describe the same topic
+    - `modelToUse` defaults to `claude-opus-4.6`; pick the model you actually want to study
+    - `modifyAnalyzedText` controls how the LLM output is parsed: `'detectEntities'` (default — mixed entities + words), `'extractEntitiesOnly'` (entity-only graph), or `'none'` (plain co-occurrence)
+    - Saves the graph by default; set `saveGraph: false` for a one-off probe. Returns analytics by default and omits the raw graph (`includeGraph: false`) to keep responses compact — enable `includeGraph` when you also need nodes/edges
+
+17. **overlap_between_texts**
+    - Create knowledge graphs from two or more texts and find the overlap (similarities) between them
+    - Use it to find similar topics and keywords across different texts
+
+18. **merged_graph_from_texts**
+    - Build a graph of all the texts and URLs provided, providing topical clusters and gaps present in the merged graph generated from all the texts
+    - Use it to combine multiple sources into one graph and see clusters and content gaps across the merged content
+
+19. **difference_between_texts**
+    - Compare knowledge graphs from two or more texts and find what's not present in the first graph that's present in the others
+    - Use it to find how one text can be enriched with the others
+
+20. **analyze_google_search_results**
+    - Generate a graph with keywords and topics for Google search results for a certain query
+    - Use it to understand the current informational supply (what people find)
+
+21. **analyze_related_search_queries**
+    - Generate a graph from the search queries suggested by Google for a certain query
+    - Use it to understand the current informational demand (what people are looking for)
+
+22. **search_queries_vs_search_results**
+    - Generate a graph of keyword combinations and topics people tend to search for that do not readily appear in the search results for the same queries
+    - Use it to understand what people search for but don't yet find
+
+23. **generate_seo_report**
+    - Analyze content for SEO optimization by comparing it with Google search results and search queries
+    - Identify content gaps and opportunities for better search visibility
+    - Get comprehensive analysis of what's in search results but not in your text
+    - Discover what people search for but don't find in current results
+
+24. **memory_add_relations**
+    - Add relations to the KeywordGraph memory from text
+    - Automatically detect entities or use [[wikilinks]] syntax to mark them
+    - Save memory to a specified graph name for future retrieval
+    - Support automatic entity extraction or manual entity marking
+    - Provide links to created memory graphs for easy access
+
+25. **memory_get_relations**
+    - Retrieve relations from KeywordGraph memory for specific entities
+    - Search for entity relations using [[wikilinks]] syntax
+    - Query specific memory contexts or search across all memory graphs
+    - Extract statements and relationships from stored knowledge graphs
+    - Support both entity-specific searches and full context retrieval
+
+26. **retrieve_from_knowledge_base**
+    - Retrieve context from an existing KeywordGraph knowledge graph using GraphRAG
+    - Query your knowledge base with a natural language prompt to get relevant statements
+    - Include graph summaries for quick overviews of the knowledge structure
+    - Optionally retrieve the full graph, statements, or extended analysis
+    - Ideal for augmenting LLM responses with domain-specific knowledge
+
+27. **search**
+    - Search through existing KeywordGraph graphs
+    - Also use it to search through the public graphs of a specific user
+    - Compatible with ChatGPT Deep Research mode via Developer Mode > Connectors
+
+28. **fetch**
+    - Fetch a specific search result for a graph
+    - Can be used in ChatGPT Deep Research mode via Developer Mode > Connectors
+
+_More capabilites coming soon!_
+
+### Key Capabilities
+
+- **Topic Modeling**: Automatic clustering and categorization of concepts
+- **Content Gap Detection**: Find missing links between concept clusters
+- **Entity Recognition**: Clean extraction of names, places, and organizations
+- **AI Enhancement**: Optional AI-powered topic naming and analysis
+- **Structural Analysis**: Identify influential nodes and community structures
+- **Network Structure Statistics**: Modularity, centrality, betweenness, and other graph metrics
+- **Knowledge Graph Memory**: Save and retrieve knowledge graph memories and analyze them to retrieve key nodes, clusters, and connectors
+
+## Knowledge Graph Memory Use Advice
+
+KeywordGraph represents any text as a network graph in order to identify the main clusters of ideas and gaps between them. This helps generate advanced insights based on the text's structure. The network is effectively a knowledge graph that can also be used to retrieve complex ontological relations between different entities and concepts. This process is automated in KeywordGraph using the `search` and `fetch` tools along with the other tools that analyze the underlying network.
+
+However, you can also easily use KeywordGraph as a more traditional memory server to save and retrieve relations. We use [[wikilinks]] to highlight entities in your text to make your content and graphs compatible with markup syntax and PKM tools such as Obsidian. By default, KeywordGraph will generate the name of the memory graph for you based on the context of the conversation. However, you can modify this default behavior by adding a **system prompt** or **project instruction** into your LLM client.
+
+Specifically you can specify to always use a speciic knowlege graph for memories to store everything in one place:
+
+```
+Save all memories in the `my-memories` graph in KeywordGraph.
+```
+
+Or you can ask KeywordGraph to only save certain entities, e.g. for building social networks:
+
+```
+When generating entities, only extract people, companies, and organizations. Ignore everything else.
+```
+
+## Installation
+
+The easiest and the fastest way to launch the KeywordGraph MCP server is to either use our server URL `https://mcp.keywordgraph.com` for the remote / web applications or to add a manual configuration to your LLM apps if you're running them locally.
+
+You can also install the server locally, so you have more control over it. In this case, you can also edit the source files and even create your tools based on the [KeywordGraph API](https://keywordgraph.com/api).
+
+Below we describe the two different ways to set up your KeywordGraph MCP server.
+
+### 1. Easiest Setup: KeywordGraph MCP Server (via HTTP/SSE)
+
+0. **Prerequisites**
+
+- Create an account on [KeywordGraph](https://keywordgraph.com) if you don't have it already and get your [KeywordGraph API Key](https://keywordgraph.com/api-access). We offer 14-day free trials.
+
+1. **Get the URL**
+
+- We currently use the following URL for our MCP server deployed in our infrastructure:
+
+```bash
+https://mcp.keywordgraph.com
+```
+
+2. **Add the MCP server URL to the Client Tool Where You Want to Use KeywordGraph**
+
+- Once you add the URL above to your tool, it will automatically prompt you to authenticate using OAuth in order to be able to access the KeywordGraph MCP hosted on it.
+
+4. **Using KeywordGraph Tools in Your Calls**
+
+- To use KeywordGraph, see the tools available and simply call them through the chat interface (e.g. "show me the graphs where I talk about this topic" or "get the content gaps from the document I uploaded")
+
+- If your client is not using KeywordGraph for some actions, add the instruction to use KeywordGraph explicitly.
+
+### 2. Manual Setup: via NPX
+
+You can deploy the KeywordGraph server manually via `npx` — a package that allows to execute local and remote Node.Js packages on your computer.
+
+The KeywordGraph MCP server is available as an npm package at [https://www.npmjs.com/package/keywordgraph-mcp-server](https://www.npmjs.com/package/keywordgraph-mcp-server) from where you can launch it remotely on your local computer with npx. It will expose its tools to the MCP client that will be using this command to launch the server
+
+#### For Claude Desktop / Cursor IDE:
+
+Just add this in your Claude's configuration file (Settings > Developer > Edit Config), inside the `"mcpServers"` object where the different servers are listed:
+
+```json
+{
+	"mcpServers": {
+		"keywordgraph": {
+			"command": "npx",
+			"args": ["-y", "keywordgraph-mcp-server"],
+			"env": {
+				"KEYWORDGRAPH_API_KEY": "YOUR_KEYWORDGRAPH_API_KEY"
+			}
+		}
+	}
+}
+```
+
+#### For Claude Code
+
+To connect the KeywordGraph MCP server to your Claude code, you can use this command. Make sure to provide the correct KeywordGraph API key for your account:
+
+```bash
+claude mcp add keywordgraph -s user \
+	-- env KEYWORDGRAPH_API_KEY=YOUR_INRANODUS_KEY \
+		npx -y keywordgraph-mcp-server
+```
+
+### 3. Manual Setup: Launching MCP as a Local Server (for inspection & development)
+
+0. **Prerequisites**
+
+- Node.js 18+ installed
+- KeywordGraph API key (get yours at [https://keywordgraph.com/api-access](https://keywordgraph.com/api-access))
+
+1. **Clone and build the server:**
+
+   ```bash
+   git clone https://github.com/yourusername/mcp-server-keywordgraph.git
+   cd mcp-server-keywordgraph
+   npm install
+   npm run build:inspect
+   npm run inspect
+   ```
+
+Note that `build:inspect` will generate the `dist/index.js` file which you will then use in your server setup. The standard `npm run build` command will only build a Smithery file.
+
+2. **Set up your API key:**
+
+   Create a `.env` file in the project root:
+
+   ```
+   KEYWORDGRAPH_API_KEY=your-api-key-here
+   ```
+
+3. **Inspect the MCP:**
+
+   ```bash
+   npm run inspect
+   ```
+
+### Claude Desktop Configuration (macOS)
+
+1. Open your Claude Desktop configuration file:
+
+   ```bash
+   open ~/Library/Application\ Support/Claude/claude_desktop_config.json
+   ```
+
+2. Add the KeywordGraph server configuration:
+
+a. remote launch via `npx`:
+
+```json
+{
+	"mcpServers": {
+		"keywordgraph": {
+			"command": "npx",
+			"args": ["-y", "keywordgraph-mcp-server"],
+			"env": {
+				"KEYWORDGRAPH_API_KEY": "YOUR_KEYWORDGRAPH_API_KEY"
+			}
+		}
+	}
+}
+```
+
+b. launch this repo with `node`, specify the absolute path to the repo + `/dist/index.js`:
+
+```json
+{
+	"mcpServers": {
+		"keywordgraph": {
+			"command": "node",
+			"args": ["/absolute/path/to/mcp-server-keywordgraph/dist/index.js"],
+			"env": {
+				"KEYWORDGRAPH_API_KEY": "your-api-key-here"
+			}
+		}
+	}
+}
+```
+
+**Note:** you can leave the `KEYWORDGRAPH_API_KEY` empty in which case you can make 70 free requests after which you will hit quota and will need to add your API key.
+
+3. Restart Claude Desktop to load the new server.
+
+### Claude Desktop Configuration (Windows)
+
+1. Open your Claude Desktop configuration file:
+
+   ```
+   %APPDATA%\Claude\claude_desktop_config.json
+   ```
+
+2. Add the KeywordGraph server configuration:
+
+a. remote launch via `npx`:
+
+```json
+{
+	"mcpServers": {
+		"keywordgraph": {
+			"command": "npx",
+			"args": ["-y", "keywordgraph-mcp-server"],
+			"env": {
+				"KEYWORDGRAPH_API_KEY": "YOUR_KEYWORDGRAPH_API_KEY"
+			}
+		}
+	}
+}
+```
+
+b. launch this repo with `node`:
+
+```json
+{
+	"mcpServers": {
+		"keywordgraph": {
+			"command": "node",
+			"args": ["C:\\path\\to\\mcp-server-keywordgraph\\dist\\index.js"],
+			"env": {
+				"KEYWORDGRAPH_API_KEY": "your-api-key-here"
+			}
+		}
+	}
+}
+```
+
+3. Restart Claude Desktop.
+
+### Cursor Configuration
+
+### Other MCP-Compatible Applications
+
+For other applications supporting MCP, use the following command to start the server via npx:
+
+```bash
+KEYWORDGRAPH_API_KEY=your-api-key npx -y keywordgraph-mcp-server
+```
+
+or locally
+
+```bash
+KEYWORDGRAPH_API_KEY=your-api-key node /path/to/mcp-server-keywordgraph/dist/index.js
+```
+
+The server communicates via stdio, so configure your application to run this command and communicate through standard input/output.
+
+### Legacy Setup via Smithery
+
+KeywordGraph server is also available through Smithery: a repository of MCP servers that has an easy-to-follow installation process for most LLM clients. You will need a separate accout at Smithery though.
+
+- Create an account on [Smithery.Ai](https://smithery.ai/) (it's free and you can use your Google or GitHub login)
+
+- Then go to the [Smithery KeywordGraph Server](https://smithery.ai/server/@keywordgraph/mcp-server-keywordgraph), click "Configure" at the top right, and add your KeywordGraph API key there.
+
+- Go to [Smithery KeywordGraph Server](https://smithery.ai/server/@keywordgraph/mcp-server-keywordgraph) and get the URL link from Smithery [https://server.smithery.ai/@keywordgraph/mcp-server-keywordgraph/mcp](https://server.smithery.ai/@keywordgraph/mcp-server-keywordgraph/mcp) for the server or use one of their automatic setup tools for Claude or Cursor.
+
+- You may need to get your separate Smithery API key and Smithery proile link to make this work.
+
+##### For Cursor:
+
+```json
+// e.g. Cursor will access directly the server via Smithery
+"mcpServers": {
+    "mcp-server-keywordgraph": {
+      "type": "http",
+      "url": "https://server.smithery.ai/@keywordgraph/mcp-server-keywordgraph/mcp?api_key=YOUR_SMITHERY_KEY&profile=YOUR_SMITHERY_PROFILE",
+      "headers": {}
+    }
+  }
+```
+
+#### For Claude:
+
+```json
+// Claude uses a slightly different implementation
+// Fot this, it launches the MCP server on your local machine
+"mcpServers": {
+   "mcp-server-keywordgraph": {
+			"command": "npx",
+			"args": [
+				"-y",
+				"@smithery/cli@latest",
+				"run",
+				"@keywordgraph/mcp-server-keywordgraph",
+				"--key",
+				"YOUR_SMITHERY_KEY",
+				"--profile",
+				"YOUR_SMITHERY_PROFILE"
+			]
+		}
+  }
+```
+
+**Note**, in both cases, you'll automatically get the `YOUR_SMITHERY_KEY` and `YOUR_SMITHERY_PROFILE` values from Smithery when you copy the URL with credentials. These are not your KeywordGraph API keys. You can use the KeywordGraph API server without the API for the first 70 calls. Then you can add it to your Smithery profile and it will automatically connect to your account using the link above.
+
+## Usage Examples
+
+Once installed, you can ask Claude to:
+
+- "Use KeywordGraph to analyze this text and show me the main topics"
+- "Generate a knowledge graph from this document"
+- "Find content gaps in this article"
+- "Retrieve my existing graph called 'Research Notes' from KeywordGraph"
+- "What are the structural gaps in this text?"
+- "Identify the most influential concepts in this content"
+
+## Development
+
+### Running in Development Mode
+
+```bash
+npm run dev
+```
+
+### Using the MCP Inspector
+
+Test the server with the MCP Inspector:
+
+```bash
+
+npm run build:inspect
+npm run inspect
+```
+
+### Building from Source
+
+```bash
+npm run build
+```
+
+### Watching for Changes
+
+```bash
+npm run watch
+```
+
+## API Documentation
+
+### generate_knowledge_graph
+
+Analyzes text and generates a knowledge graph.
+
+**Parameters:**
+
+- `text` (string, required): The text to analyze
+- `includeStatements` (boolean): Include original statements in response
+- `modifyAnalyzedText` (string): Text modification options ("none", "entities", "lemmatize")
+
+### analyze_existing_graph_by_name
+
+Retrieves and analyzes an existing graph from your KeywordGraph account.
+
+**Parameters:**
+
+- `graphName` (string, required): Name of the existing graph
+- `includeStatements` (boolean): Include statements in response
+- `includeGraphSummary` (boolean): Include graph summary
+
+### analyze_text
+
+Analyze a text, URL, or YouTube transcript. Extract and analyze a graph from text or URL; provide either text or url.
+
+**Parameters:**
+
+- `text` (string, optional): Text to analyze. Provide either this or url.
+- `url` (string, optional): URL to fetch content from (e.g. webpage or YouTube transcript). Provide either this or text.
+- `includeStatements` (boolean): Include processed statements in response
+- `includeGraph` (boolean): Include full graph structure in response
+- `addNodesAndEdges` (boolean): Include nodes and edges in response
+- `includeGraphSummary` (boolean): Include AI-generated graph summary for RAG prompt augmentation
+- `modifyAnalyzedText` (string): Entity detection — "none", "detectEntities", or "extractEntitiesOnly"
+
+### generate_content_gaps
+
+Identifies content gaps and missing connections in text.
+
+**Parameters:**
+
+- `text` (string, required): The text to analyze for gaps
+
+## Progress Notifications
+
+For long-running operations (like SEO analysis), the MCP server supports **real-time progress notifications** that provide intermediary feedback to AI agents. This allows agents to:
+
+- Track the progress of multi-step operations
+- Display status messages to users
+- Understand what's happening during lengthy analyses
+
+### Implementation
+
+The server implements MCP progress notifications using:
+
+1. **ToolHandlerContext**: All tool handlers can receive an optional context parameter containing the server instance and progress token
+2. **ProgressReporter**: A utility class that simplifies sending progress updates with percentages and messages
+3. **Wrapped Handlers**: Tool registration automatically injects the server context into handlers
+
+### Example Usage in Tools
+
+```typescript
+import { ProgressReporter } from "../utils/progress.js";
+import { ToolHandlerContext } from "../types/index.js";
+
+handler: async (params: ParamType, context: ToolHandlerContext = {}) => {
+	const progress = new ProgressReporter(context);
+
+	await progress.report(25, "Fetching data from API...");
+	// Do work
+
+	await progress.report(75, "Analyzing results...");
+	// More work
+
+	await progress.report(100, "Complete!");
+	return results;
+};
+```
+
+The `generate_seo_report` tool demonstrates this pattern with 6 major progress checkpoints that provide detailed status updates throughout the multi-step analysis process.
+
+## Troubleshooting
+
+### Server doesn't appear in Claude
+
+1. Verify the configuration file path is correct
+2. Check that the API key is valid
+3. Ensure Node.js is in your system PATH
+4. Restart Claude Desktop completely
+
+### API Key Issues
+
+- Get your API key at: [https://keywordgraph.com/api-access](https://keywordgraph.com/api-access)
+- Ensure the key is correctly set in the configuration
+- Check that the key has not expired
+
+### Build Errors
+
+```bash
+# Clean install
+rm -rf node_modules package-lock.json
+npm install
+npm run build
+```
+
+## Resources
+
+- [KeywordGraph Website](https://keywordgraph.com)
+- [KeywordGraph MCP](https://keywordgraph.com/mcp)
+- [KeywordGraph API Documentation](https://keywordgraph.com/api-access)
+- [MCP Protocol Documentation](https://modelcontextprotocol.io)
+- [Graph Theory Concepts](https://noduslabs.com/research/)
+
+## License
+
+MIT
+
+## Support
+
+For issues related to:
+
+- This MCP server: Open an issue in this repository
+- KeywordGraph API: Contact support@keywordgraph.com
+- MCP Protocol: Visit the [MCP community](https://modelcontextprotocol.io)

package/bin/infranodus-mcp-server.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+// Brand-specific entry for the published `infranodus-mcp-server` package.
+// Bakes in BRAND so `npx infranodus-mcp-server` runs as InfraNodus without
+// the caller needing to set any env var. An explicit BRAND still wins.
+// NOTE: must use dynamic import — a static import would be hoisted and run
+// before this assignment, so brand.js would read BRAND too early.
+process.env.BRAND ||= "infranodus";
+await import("./mcp-server.js");

package/bin/keywordgraph-mcp-server.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+// Brand-specific entry for the published `keywordgraph-mcp-server` package.
+// Bakes in BRAND so `npx keywordgraph-mcp-server` runs as KeywordGraph without
+// the caller needing to set any env var. An explicit BRAND still wins.
+// NOTE: must use dynamic import — a static import would be hoisted and run
+// before this assignment, so brand.js would read BRAND too early.
+process.env.BRAND ||= "keywordgraph";
+await import("./mcp-server.js");