home / mcp / ekms mcp server

EKMS MCP Server

Enables querying and managing knowledge from EKMS via MCP endpoints for search, recommendations, item retrieval, and feedback.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jihsin-ekms-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/ekms-mcp-server/src/index.js"
      ],
      "env": {
        "EKMS_API_KEY": "your-api-key",
        "EKMS_API_URL": "http://localhost:3000"
      }
    }
  }
}

This MCP server enables Claude Code to query and interact with your Enterprise Knowledge Management System data. It provides a bridge that lets you search, fetch, and understand knowledge items, while also recording feedback and surfacing knowledge graphs to improve response quality.

How to use

Connect your MCP client to the EKMS MCP server to perform knowledge operations from Claude Code or the CLI. You can start the server locally and reference it in your client configuration, so you can search the knowledge base, get full knowledge items, list knowledge types, and view recommendations based on context.

How to install

Prerequisites you need before installing this MCP server:

- Node.js installed on your machine.

Install steps

# 1) Install dependencies in the MCP server folder
cd ekms-mcp-server
npm install

2) Create a local environment file based on the template and customize values for your EKMS API connection.

cp .env.example .env

3) Edit the environment variables to point to your EKMS API and provide the API key.

# .env
EKMS_API_URL=http://localhost:3000
EKMS_API_KEY=your-api-key

4) Start the server locally to verify it runs and listens for MCP connections.

npm start

5) If you are configuring Claude Code, provide the MCP connection using the following example configuration.

{
  "mcpServers": {
    "ekms": {
      "command": "node",
      "args": ["/path/to/ekms-mcp-server/src/index.js"],
      "env": {
        "EKMS_API_URL": "http://localhost:3000",
        "EKMS_API_KEY": "your-api-key"
      }
    }
  }
}

Additional installation notes

If you prefer using the Claude CLI, you can add the MCP endpoint with a direct command that runs the MCP server locally.

claude mcp add ekms node /path/to/ekms-mcp-server/src/index.js

Configuration and usage details

Environment variables are used to connect to the EKMS API. Keep your API key secure and share it only with trusted clients. The MCP server exposes a set of capabilities to interact with knowledge data, including search, recommendations, item retrieval, and feedback recording.

Notes

Development workflow includes a dev mode for automatic reloading and tests to ensure functionality. You can run development and test commands from the project root.

Security considerations

Treat EKMS_API_KEY as a secret and rotate it periodically. Use network access controls to restrict who can connect to the EKMS API and the MCP server, and store credentials in a secure location appropriate for your environment.

Available tools

search_knowledge

Search the knowledge base with support for hybrid, semantic, and keyword search modes.

recommend_knowledge

Recommend knowledge items based on context and customer characteristics.

get_knowledge_item

Fetch the full content of a specific knowledge item.

list_knowledge_types

List all knowledge types available in the system.

list_customers

List all customers stored in the EKMS.

get_knowledge_graph

Retrieve the knowledge graph showing relationships between items.

record_knowledge_feedback

Record feedback on knowledge usage to improve future results.