Skip to main content
Glama
enterprise-knowledge-mcp

enterprise-knowledge-mcp

by xuenyuxey

Enterprise Knowledge MCP

Model Context Protocol (MCP) 기반의 엔터프라이즈 지식 관리 서비스입니다.

대규모 언어 모델에 세 가지 핵심 기능을 제공합니다:

도구

기능

search_knowledge

의미 기반 기업 지식 베이스 검색

get_document

문서 ID로 전체 문서 가져오기

search_cases

기업 프로젝트 사례 검색

프로젝트 구조

enterprise-knowledge-mcp/
├── src/
│   └── enterprise_knowledge_mcp/
│       ├── __init__.py          # 包入口
│       ├── server.py            # MCP 工具注册(协议层)
│       └── retriever.py         # 检索逻辑(业务层)
├── tests/
│   ├── test_server.py           # 单元测试
│   └── test_e2e.py              # MCP Client 端到端测试
├── scripts/
│   ├── seed_data.py             # 导入示例数据到 ChromaDB
│   └── download_model.py        # 下载嵌入模型(离线环境用)
├── pyproject.toml
├── server.json                  # MCP 服务描述清单
├── README.md
└── LICENSE

Related MCP server: MCP Knowledge Base Server

아키텍처 설계

┌─────────────────────────────────────────┐
│  server.py  (协议层)                     │
│  - 注册 MCP Tool                        │
│  - 参数校验 & 输出格式化                  │
└──────────────┬──────────────────────────┘
               │ 调用
┌──────────────▼──────────────────────────┐
│  retriever.py  (业务层)                  │
│  - KnowledgeRetriever  知识库检索        │
│  - DocumentRetriever   文档检索          │
│  - CaseRetriever       案例检索          │
└──────────────┬──────────────────────────┘
               │ 替换实现
┌──────────────▼──────────────────────────┐
│  数据层(可插拔)                         │
│  - MockRetriever     开发/测试用          │
│  - ChromaRetriever   ChromaDB 向量检索   │
│  - 自定义 Retriever   ES / 数据库 / ...   │
└─────────────────────────────────────────┘

검색기는 기반 클래스 + 구현 방식의 플러그인 설계를 채택합니다. server.py에서 인스턴스화된 객체만 교체하면 백엔드를 전환할 수 있으며, 도구 등록 코드는 수정할 필요가 없습니다.

빠른 시자

설치

# 克隆仓库
git clone https://github.com/your-username/enterprise-knowledge-mcp.git
cd enterprise-knowledge-mcp

# 创建虚拟环境
python -m venv .venv
.venv\Scripts\activate        # Windows
# source .venv/bin/activate   # Linux/macOS

# 安装(开发模式)
pip install -e ".[dev]"

ChromaDB 데이터 초기화

# 导入示例企业知识数据(知识库 5 条、文档 3 篇、案例 4 个)
python scripts/seed_data.py

서비스 실행

# Mock 模式(无需 ChromaDB 数据)
python -m enterprise_knowledge_mcp.server

# ChromaDB 模式(需先执行 seed_data.py)
RETRIEVER_BACKEND=chroma python -m enterprise_knowledge_mcp.server

테스트 실행

pytest tests/ -v

MCP 클라인언트 연동

Claude Desktop

claude_desktop_conig.jon에 다음을 추가합니다:

{
  "mcpServers": {
    "enterprise-knowledge": {
      "command": "python",
      "args": ["-m", "enterprise_knowledge_mcp.server"],
      "cwd": "C:/path/to/enterprise-knowledge-mcp"
    }
  }
}

Python SDK

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

server_params = StdioServerParameters(
    command="python",
    args=["-m", "enterprise_knowledge_mcp.server"],
)

async with stdio_client(server_params) as (read, write):
    async with ClientSession(read, write) as session:
        await session.initialize()
        result = await session.call_tool(
            "search_knowledge", {"query": "人工智能"}
        )
        print(result.content[0].text)

사용자 정의 검색기

기반 클래스를 상속하고 retrieve / get_document / search_cases 메서드를 구현합니다:

from enterprise_knowledge_mcp.retriever import (
    KnowledgeRetriever,
    SearchResult,
)

class MyRetriever(KnowledgeRetriever):
    def retrieve(self, query: str, top_k: int = 5) -> list[SearchResult]:
        # 你的检索逻辑
        return [SearchResult(text="...", source="...", score=0.9)]

그런 다음 server.py에서 교체합니다:

from .retriever import MyRetriever

knowledge_retriever = MyRetriever()

라이선스

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers