mcp-knowledge-graph 0.1.1__tar.gz

mcp_knowledge_graph-0.1.1/.dockerignore

@@ -0,0 +1,14 @@
+.venv/
+.pytest_cache/
+__pycache__/
+*.pyc
+*.pyo
+.git/
+.gitignore
+.cursor/
+openspec/
+dev_memory/
+tests/
+.env
+*.md
+!README.md

mcp_knowledge_graph-0.1.1/.env.example

@@ -0,0 +1,15 @@
+NEO4J_URI=bolt://192.168.0.18:7687
+NEO4J_USER=neo4j
+NEO4J_PASSWORD=password
+NEO4J_DATABASE=neo4j
+
+# MCP 传输：stdio | streamable-http | sse
+MCP_TRANSPORT=stdio
+MCP_HOST=0.0.0.0
+MCP_PORT=8000
+MCP_SSE_PATH=/sse
+MCP_STREAMABLE_HTTP_PATH=/mcp
+# 局域网访问时配置对外 Host（逗号分隔）；127.0.0.1/localhost 会自动并入白名单
+MCP_ALLOWED_HOSTS=192.168.101.244:7688
+MCP_ALLOWED_ORIGINS=http://192.168.101.244:*
+# MCP_DISABLE_TRANSPORT_SECURITY=false

mcp_knowledge_graph-0.1.1/Dockerfile

@@ -0,0 +1,43 @@
+# Neo4j 知识图谱检索 MCP 服务
+FROM python:3.11-slim-bookworm
+
+WORKDIR /app
+
+# 系统依赖（可选，用于健康检查等）
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# 先复制依赖声明，利用 Docker 层缓存
+COPY pyproject.toml README.md ./
+COPY src/ src/
+COPY data/ data/
+
+RUN pip install --no-cache-dir --upgrade pip \
+    && pip install --no-cache-dir .
+
+COPY scripts/docker-entrypoint.sh /usr/local/bin/docker-entrypoint.sh
+RUN chmod +x /usr/local/bin/docker-entrypoint.sh
+
+ENV PYTHONUNBUFFERED=1 \
+    PYTHONDONTWRITEBYTECODE=1 \
+    MCP_TRANSPORT=streamable-http \
+    MCP_HOST=0.0.0.0 \
+    MCP_PORT=8000 \
+    MCP_STREAMABLE_HTTP_PATH=/mcp \
+    NEO4J_URI=bolt://neo4j:7687 \
+    NEO4J_USER=neo4j \
+    NEO4J_PASSWORD=password \
+    NEO4J_DATABASE=neo4j
+
+EXPOSE 8000
+
+HEALTHCHECK --interval=30s --timeout=5s --start-period=15s --retries=3 \
+    CMD curl -sf -o /dev/null -w "%{http_code}" \
+        -X POST "http://127.0.0.1:${MCP_PORT}/mcp" \
+        -H "Content-Type: application/json" \
+        -H "Accept: application/json, text/event-stream" \
+        -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"healthcheck","version":"1.0"}}}' \
+        | grep -q 200 || exit 1
+
+ENTRYPOINT ["docker-entrypoint.sh"]

mcp_knowledge_graph-0.1.1/PKG-INFO

@@ -0,0 +1,196 @@
+Metadata-Version: 2.4
+Name: mcp-knowledge-graph
+Version: 0.1.1
+Summary: Neo4j knowledge graph retrieval MCP server
+Requires-Python: >=3.11
+Requires-Dist: mcp>=1.6.0
+Requires-Dist: neo4j>=5.0.0
+Requires-Dist: pydantic-settings>=2.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: twine>=6.2.0
+Description-Content-Type: text/markdown
+
+# Neo4j Knowledge Graph MCP Server
+
+MCP server for enterprise knowledge graph retrieval over Neo4j. Client LLM generates Cypher; this server provides schema resources, validation, and read-only execution.
+
+> 中文详细说明请参阅：[docs/知识图谱检索MCP服务说明.md](docs/知识图谱检索MCP服务说明.md)
+
+## Architecture
+
+- **10 Resources**: 7 static (schema, constraints, conventions, semantics, glossary, patterns, safety) + 3 dynamic (stats, samples, indexes)
+- **7 Tools**: `get_graph_context`, `get_cypher_prompt`, `validate_cypher`, `execute_cypher`, `explain_cypher`, `resolve_entity`, `refresh_graph_stats`
+- **4 Prompts**: `generate_cypher_query`, `refine_cypher_query`, `explain_query_result`, `decompose_complex_question`
+
+Context Tools (`get_graph_context_tool`, `get_cypher_prompt_tool`) provide the same schema context as Resources/Prompts for **Tools-only** MCP clients that do not support `resources/read` or `prompts/get`.
+
+## Setup
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+pip install mcp neo4j pyyaml pydantic pydantic-settings
+```
+
+Environment variables:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `NEO4J_URI` | `bolt://localhost:7687` | Neo4j Bolt URI |
+| `NEO4J_USER` | `neo4j` | Neo4j user |
+| `NEO4J_PASSWORD` | `password` | Neo4j password |
+| `NEO4J_DATABASE` | `neo4j` | Neo4j database |
+| `MCP_TRANSPORT` | `stdio` | `stdio` \| `streamable-http` \| `sse` |
+| `MCP_HOST` | `127.0.0.1` | HTTP/SSE bind host |
+| `MCP_PORT` | `8000` | HTTP/SSE bind port |
+| `MCP_SSE_PATH` | `/sse` | SSE endpoint path |
+| `MCP_STREAMABLE_HTTP_PATH` | `/mcp` | Streamable HTTP endpoint path |
+
+Copy `.env.example` to `.env` and adjust as needed.
+
+## Import graph data
+
+From ontology_system:
+
+```bash
+curl -o graph-import.cypher http://localhost:8183/graph/export/cypher
+cypher-shell -u neo4j -p password -f graph-import.cypher
+```
+
+## Run MCP server
+
+### stdio（默认，Cursor 子进程模式）
+
+```bash
+PYTHONPATH=. python -m src.server
+```
+
+### streamable-http（推荐 HTTP 模式）
+
+```bash
+PYTHONPATH=. python -m src.server --transport streamable-http --host 127.0.0.1 --port 8000
+```
+
+Endpoint: `http://127.0.0.1:8000/mcp`
+
+### SSE
+
+```bash
+PYTHONPATH=. python -m src.server --transport sse --host 127.0.0.1 --port 8000
+```
+
+Endpoint: `http://127.0.0.1:8000/sse`
+
+### 局域网访问（Cherry Studio 等远程客户端）
+
+绑定 `0.0.0.0` 时，必须配置允许的 Host 头，否则会出现 `421 Misdirected Request`：
+
+```bash
+PYTHONPATH=. python -m src.server \
+  --transport streamable-http \
+  --host 0.0.0.0 \
+  --port 7688 \
+  --allowed-host 192.168.0.18:7688
+```
+
+或使用环境变量：
+
+```bash
+export MCP_ALLOWED_HOSTS=192.168.0.18:7688
+PYTHONPATH=. python -m src.server --transport streamable-http --host 0.0.0.0 --port 7688
+```
+
+局域网临时调试可加 `--disable-transport-security`（不推荐生产环境）。
+
+> 绑定 `0.0.0.0` 前请确认网络访问控制；生产环境建议置于反向代理之后。
+
+## Cursor MCP configuration
+
+### stdio（command）
+
+```json
+{
+  "mcpServers": {
+    "knowledge-graph": {
+      "command": "/path/to/mcp_knowledge_graph/.venv/bin/python",
+      "args": ["-m", "src.server"],
+      "cwd": "/path/to/mcp_knowledge_graph",
+      "env": {
+        "PYTHONPATH": "/path/to/mcp_knowledge_graph",
+        "NEO4J_URI": "bolt://192.168.0.18:7687",
+        "NEO4J_PASSWORD": "password"
+      }
+    }
+  }
+}
+```
+
+### streamable-http（url，含 Cherry Studio）
+
+先启动服务（局域网需 `--allowed-host`）：
+
+```bash
+PYTHONPATH=. python -m src.server \
+  --transport streamable-http \
+  --host 0.0.0.0 \
+  --port 7688 \
+  --allowed-host 192.168.0.18:7688
+```
+
+Cherry Studio JSON 配置：
+
+```json
+{
+  "mcpServers": {
+    "knowledge-graph": {
+      "url": "http://192.168.0.18:7688/mcp"
+    }
+  }
+}
+```
+
+也可通过 args 指定 transport：
+
+```json
+{
+  "mcpServers": {
+    "knowledge-graph": {
+      "command": "/path/to/mcp_knowledge_graph/.venv/bin/python",
+      "args": ["-m", "src.server", "--transport", "streamable-http", "--port", "8000"],
+      "cwd": "/path/to/mcp_knowledge_graph",
+      "env": {
+        "PYTHONPATH": "/path/to/mcp_knowledge_graph"
+      }
+    }
+  }
+}
+```
+
+## Verify pipeline
+
+```bash
+PYTHONPATH=. python scripts/verify_import_pipeline.py
+```
+
+## Tests
+
+```bash
+PYTHONPATH=. pytest tests/ -v
+```
+
+## Workflow
+
+### Full MCP client (Resources + Prompts)
+
+1. Client reads `graph://schema`, `graph://ontology-constraints`, `graph://query-patterns`
+2. Optional: `resolve_entity` for name disambiguation
+3. Client LLM uses `generate_cypher_query` prompt to produce Cypher JSON
+4. `validate_cypher` → `execute_cypher` → `explain_query_result`
+
+### Tools-only client
+
+1. `get_cypher_prompt_tool(question=...)` or `get_graph_context_tool(scope="core")`
+2. Optional: `resolve_entity` → pass result as `entity_hints`
+3. Platform LLM generates Cypher JSON from returned prompt fields
+4. `validate_cypher` → `execute_cypher` → platform LLM explains records

mcp_knowledge_graph-0.1.1/README.md

@@ -0,0 +1,183 @@
+# Neo4j Knowledge Graph MCP Server
+
+MCP server for enterprise knowledge graph retrieval over Neo4j. Client LLM generates Cypher; this server provides schema resources, validation, and read-only execution.
+
+> 中文详细说明请参阅：[docs/知识图谱检索MCP服务说明.md](docs/知识图谱检索MCP服务说明.md)
+
+## Architecture
+
+- **10 Resources**: 7 static (schema, constraints, conventions, semantics, glossary, patterns, safety) + 3 dynamic (stats, samples, indexes)
+- **7 Tools**: `get_graph_context`, `get_cypher_prompt`, `validate_cypher`, `execute_cypher`, `explain_cypher`, `resolve_entity`, `refresh_graph_stats`
+- **4 Prompts**: `generate_cypher_query`, `refine_cypher_query`, `explain_query_result`, `decompose_complex_question`
+
+Context Tools (`get_graph_context_tool`, `get_cypher_prompt_tool`) provide the same schema context as Resources/Prompts for **Tools-only** MCP clients that do not support `resources/read` or `prompts/get`.
+
+## Setup
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+pip install mcp neo4j pyyaml pydantic pydantic-settings
+```
+
+Environment variables:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `NEO4J_URI` | `bolt://localhost:7687` | Neo4j Bolt URI |
+| `NEO4J_USER` | `neo4j` | Neo4j user |
+| `NEO4J_PASSWORD` | `password` | Neo4j password |
+| `NEO4J_DATABASE` | `neo4j` | Neo4j database |
+| `MCP_TRANSPORT` | `stdio` | `stdio` \| `streamable-http` \| `sse` |
+| `MCP_HOST` | `127.0.0.1` | HTTP/SSE bind host |
+| `MCP_PORT` | `8000` | HTTP/SSE bind port |
+| `MCP_SSE_PATH` | `/sse` | SSE endpoint path |
+| `MCP_STREAMABLE_HTTP_PATH` | `/mcp` | Streamable HTTP endpoint path |
+
+Copy `.env.example` to `.env` and adjust as needed.
+
+## Import graph data
+
+From ontology_system:
+
+```bash
+curl -o graph-import.cypher http://localhost:8183/graph/export/cypher
+cypher-shell -u neo4j -p password -f graph-import.cypher
+```
+
+## Run MCP server
+
+### stdio（默认，Cursor 子进程模式）
+
+```bash
+PYTHONPATH=. python -m src.server
+```
+
+### streamable-http（推荐 HTTP 模式）
+
+```bash
+PYTHONPATH=. python -m src.server --transport streamable-http --host 127.0.0.1 --port 8000
+```
+
+Endpoint: `http://127.0.0.1:8000/mcp`
+
+### SSE
+
+```bash
+PYTHONPATH=. python -m src.server --transport sse --host 127.0.0.1 --port 8000
+```
+
+Endpoint: `http://127.0.0.1:8000/sse`
+
+### 局域网访问（Cherry Studio 等远程客户端）
+
+绑定 `0.0.0.0` 时，必须配置允许的 Host 头，否则会出现 `421 Misdirected Request`：
+
+```bash
+PYTHONPATH=. python -m src.server \
+  --transport streamable-http \
+  --host 0.0.0.0 \
+  --port 7688 \
+  --allowed-host 192.168.0.18:7688
+```
+
+或使用环境变量：
+
+```bash
+export MCP_ALLOWED_HOSTS=192.168.0.18:7688
+PYTHONPATH=. python -m src.server --transport streamable-http --host 0.0.0.0 --port 7688
+```
+
+局域网临时调试可加 `--disable-transport-security`（不推荐生产环境）。
+
+> 绑定 `0.0.0.0` 前请确认网络访问控制；生产环境建议置于反向代理之后。
+
+## Cursor MCP configuration
+
+### stdio（command）
+
+```json
+{
+  "mcpServers": {
+    "knowledge-graph": {
+      "command": "/path/to/mcp_knowledge_graph/.venv/bin/python",
+      "args": ["-m", "src.server"],
+      "cwd": "/path/to/mcp_knowledge_graph",
+      "env": {
+        "PYTHONPATH": "/path/to/mcp_knowledge_graph",
+        "NEO4J_URI": "bolt://192.168.0.18:7687",
+        "NEO4J_PASSWORD": "password"
+      }
+    }
+  }
+}
+```
+
+### streamable-http（url，含 Cherry Studio）
+
+先启动服务（局域网需 `--allowed-host`）：
+
+```bash
+PYTHONPATH=. python -m src.server \
+  --transport streamable-http \
+  --host 0.0.0.0 \
+  --port 7688 \
+  --allowed-host 192.168.0.18:7688
+```
+
+Cherry Studio JSON 配置：
+
+```json
+{
+  "mcpServers": {
+    "knowledge-graph": {
+      "url": "http://192.168.0.18:7688/mcp"
+    }
+  }
+}
+```
+
+也可通过 args 指定 transport：
+
+```json
+{
+  "mcpServers": {
+    "knowledge-graph": {
+      "command": "/path/to/mcp_knowledge_graph/.venv/bin/python",
+      "args": ["-m", "src.server", "--transport", "streamable-http", "--port", "8000"],
+      "cwd": "/path/to/mcp_knowledge_graph",
+      "env": {
+        "PYTHONPATH": "/path/to/mcp_knowledge_graph"
+      }
+    }
+  }
+}
+```
+
+## Verify pipeline
+
+```bash
+PYTHONPATH=. python scripts/verify_import_pipeline.py
+```
+
+## Tests
+
+```bash
+PYTHONPATH=. pytest tests/ -v
+```
+
+## Workflow
+
+### Full MCP client (Resources + Prompts)
+
+1. Client reads `graph://schema`, `graph://ontology-constraints`, `graph://query-patterns`
+2. Optional: `resolve_entity` for name disambiguation
+3. Client LLM uses `generate_cypher_query` prompt to produce Cypher JSON
+4. `validate_cypher` → `execute_cypher` → `explain_query_result`
+
+### Tools-only client
+
+1. `get_cypher_prompt_tool(question=...)` or `get_graph_context_tool(scope="core")`
+2. Optional: `resolve_entity` → pass result as `entity_hints`
+3. Platform LLM generates Cypher JSON from returned prompt fields
+4. `validate_cypher` → `execute_cypher` → platform LLM explains records

mcp_knowledge_graph-0.1.1/data/ontology_schema.json

@@ -0,0 +1,26 @@
+{
+  "ontology": {
+    "entity_types": {
+      "Organization": ["Group", "Company", "Department", "Team"],
+      "Person": ["Employee", "Manager", "Director", "External"],
+      "System": ["BusinessSystem", "ITSystem", "Platform", "Application"],
+      "Asset": ["Hardware", "Software", "Device"],
+      "Document": ["Policy", "Report", "Contract", "Manual"],
+      "Location": ["Office", "Branch", "Site"],
+      "Project": ["InitProject", "OperateProject"],
+      "Product": ["InternalProduct", "ExternalProduct"],
+      "Event": ["Meeting", "Audit", "Incident", "Release"]
+    },
+    "relation_types": {
+      "reports_to": {"domain": ["Person"], "range": ["Person"], "symmetric": false},
+      "belongs_to": {"domain": ["Person", "System", "Asset", "Team"], "range": ["Organization"]},
+      "controls": {"domain": ["Person", "Organization"], "range": ["System", "Asset", "Project"]},
+      "depends_on": {"domain": ["System", "Project"], "range": ["System", "Asset", "Project"]},
+      "uses": {"domain": ["Person", "Organization", "System"], "range": ["System", "Asset", "Product"]},
+      "maintains": {"domain": ["Person", "Team"], "range": ["System", "Asset"]},
+      "created_by": {"domain": ["System", "Product", "Document"], "range": ["Person", "Team"]},
+      "located_in": {"domain": ["Organization", "System", "Asset"], "range": ["Location"]},
+      "participates_in": {"domain": ["Person", "Team"], "range": ["Project", "Event"]}
+    }
+  }
+}

mcp_knowledge_graph-0.1.1/data/query_patterns.yaml

@@ -0,0 +1,109 @@
+patterns:
+  - id: who_maintains_system
+    description: 谁维护某系统？
+    question_example: 谁维护 CRM 系统？
+    cypher: |
+      MATCH (p:Person)-[r:maintains]->(s:System)
+      WHERE s.name CONTAINS $system_name
+      RETURN p.name AS person, p.subtype AS subtype, r.confidence AS confidence, r.evidence_text AS evidence
+      LIMIT 20
+    parameters:
+      system_name: "CRM"
+
+  - id: dept_controls_systems
+    description: 某部门控制的系统及其依赖
+    question_example: 技术部控制了哪些系统，它们依赖什么？
+    cypher: |
+      MATCH (o:Organization)-[:controls]->(s:System)
+      WHERE o.name CONTAINS $dept_name
+      OPTIONAL MATCH (s)-[d:depends_on]->(dep)
+      RETURN o.name AS department, s.name AS system, collect(DISTINCT dep.name) AS dependencies
+      LIMIT 50
+    parameters:
+      dept_name: "技术部"
+
+  - id: person_reports_to
+    description: 某人的汇报关系
+    question_example: 张三向谁汇报？
+    cypher: |
+      MATCH (p:Person)-[r:reports_to]->(mgr:Person)
+      WHERE p.name CONTAINS $person_name
+      RETURN p.name AS person, mgr.name AS manager, r.confidence AS confidence
+      LIMIT 10
+    parameters:
+      person_name: "张三"
+
+  - id: system_dependencies
+    description: 某系统依赖哪些系统或资产
+    question_example: ERP 系统依赖什么？
+    cypher: |
+      MATCH (s:System)-[r:depends_on]->(dep)
+      WHERE s.name CONTAINS $system_name
+      RETURN s.name AS system, labels(dep)[0] AS dep_type, dep.name AS dependency, r.confidence AS confidence
+      LIMIT 30
+    parameters:
+      system_name: "ERP"
+
+  - id: org_belongs_to
+    description: 某人/系统属于哪个组织
+    question_example: 李四属于哪个部门？
+    cypher: |
+      MATCH (n)-[r:belongs_to]->(o:Organization)
+      WHERE n.name CONTAINS $entity_name AND (n:Person OR n:System OR n:Asset)
+      RETURN n.name AS entity, labels(n)[0] AS entity_type, o.name AS organization, r.confidence AS confidence
+      LIMIT 10
+    parameters:
+      entity_name: "李四"
+
+  - id: entity_neighbors
+    description: 某实体 N 跳邻居子图
+    question_example: CRM 系统周围有哪些关联实体？
+    cypher: |
+      MATCH (center {name: $entity_name})-[*1..2]-(neighbor)
+      WHERE center.name CONTAINS $entity_name
+      RETURN DISTINCT labels(neighbor)[0] AS type, neighbor.name AS name, neighbor.id AS id
+      LIMIT 50
+    parameters:
+      entity_name: "CRM"
+
+  - id: high_confidence_relations
+    description: 高置信度关系查询
+    question_example: 有哪些高置信度的系统依赖关系？
+    cypher: |
+      MATCH (a)-[r:depends_on]->(b)
+      WHERE r.confidence = 'high'
+      RETURN labels(a)[0] AS from_type, a.name AS from_name, labels(b)[0] AS to_type, b.name AS to_name, r.evidence_text AS evidence
+      LIMIT 30
+
+  - id: document_created_by
+    description: 某文档的创建者
+    question_example: 安全策略文档是谁创建的？
+    cypher: |
+      MATCH (d:Document)-[r:created_by]->(creator)
+      WHERE d.name CONTAINS $doc_name
+      RETURN d.name AS document, labels(creator)[0] AS creator_type, creator.name AS creator, r.confidence AS confidence
+      LIMIT 10
+    parameters:
+      doc_name: "安全策略"
+
+  - id: project_participants
+    description: 某项目的参与者
+    question_example: 数字化转型项目有哪些参与者？
+    cypher: |
+      MATCH (p)-[r:participates_in]->(proj:Project)
+      WHERE proj.name CONTAINS $project_name
+      RETURN proj.name AS project, labels(p)[0] AS participant_type, p.name AS participant, r.confidence AS confidence
+      LIMIT 30
+    parameters:
+      project_name: "数字化转型"
+
+  - id: location_entities
+    description: 某地点有哪些组织/系统/资产
+    question_example: 北京办公室有哪些系统？
+    cypher: |
+      MATCH (n)-[r:located_in]->(loc:Location)
+      WHERE loc.name CONTAINS $location_name
+      RETURN loc.name AS location, labels(n)[0] AS entity_type, n.name AS entity_name
+      LIMIT 50
+    parameters:
+      location_name: "北京"

mcp_knowledge_graph-0.1.1/docker-compose.yml

@@ -0,0 +1,36 @@
+services:
+  neo4j:
+    image: neo4j:5
+    container_name: kg-neo4j
+    restart: unless-stopped
+    ports:
+      - "7474:7474"
+      - "7687:7687"
+    environment:
+      NEO4J_AUTH: neo4j/password
+    volumes:
+      - neo4j_data:/data
+      - neo4j_logs:/logs
+
+  mcp-knowledge-graph:
+    build: .
+    container_name: kg-mcp
+    restart: unless-stopped
+    ports:
+      - "7688:8000"
+    environment:
+      NEO4J_URI: bolt://neo4j:7687
+      NEO4J_USER: neo4j
+      NEO4J_PASSWORD: password
+      NEO4J_DATABASE: neo4j
+      MCP_TRANSPORT: streamable-http
+      MCP_HOST: 0.0.0.0
+      MCP_PORT: 8000
+      # 局域网客户端访问时改为宿主机 IP，例如 192.168.0.18:7688
+      MCP_ALLOWED_HOSTS: "127.0.0.1:8000,192.168.0.18:7688,localhost:7688"
+    depends_on:
+      - neo4j
+
+volumes:
+  neo4j_data:
+  neo4j_logs:

mcp_knowledge_graph-0.1.1/pyproject.toml

@@ -0,0 +1,32 @@
+[project]
+name = "mcp-knowledge-graph"
+version = "0.1.1"
+description = "Neo4j knowledge graph retrieval MCP server"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "mcp>=1.6.0",
+    "neo4j>=5.0.0",
+    "pyyaml>=6.0",
+    "pydantic>=2.0",
+    "pydantic-settings>=2.0",
+    "twine>=6.2.0",
+]
+
+[project.scripts]
+mcp-knowledge-graph = "src.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src"]
+
+[tool.hatch.build.targets.wheel.force-include]
+"data" = "data"
+
+
+[tool.pytest.ini_options]
+pythonpath = ["."]
+testpaths = ["tests"]

mcp_knowledge_graph-0.1.1/scripts/docker-entrypoint.sh

@@ -0,0 +1,37 @@
+#!/bin/sh
+set -e
+
+TRANSPORT="${MCP_TRANSPORT:-streamable-http}"
+HOST="${MCP_HOST:-0.0.0.0}"
+PORT="${MCP_PORT:-8000}"
+
+set -- \
+    python -m src.server \
+    --transport "${TRANSPORT}" \
+    --host "${HOST}" \
+    --port "${PORT}"
+
+if [ -n "${MCP_SSE_PATH}" ]; then
+    set -- "$@" --sse-path "${MCP_SSE_PATH}"
+fi
+
+if [ -n "${MCP_STREAMABLE_HTTP_PATH}" ]; then
+    set -- "$@" --streamable-http-path "${MCP_STREAMABLE_HTTP_PATH}"
+fi
+
+if [ -n "${MCP_ALLOWED_HOSTS}" ]; then
+    set -- "$@" --allowed-host "${MCP_ALLOWED_HOSTS}"
+fi
+
+if [ -n "${MCP_ALLOWED_ORIGINS}" ]; then
+    set -- "$@" --allowed-origin "${MCP_ALLOWED_ORIGINS}"
+fi
+
+if [ "${MCP_DISABLE_TRANSPORT_SECURITY}" = "true" ]; then
+    set -- "$@" --disable-transport-security
+elif [ "${HOST}" = "0.0.0.0" ] && [ -z "${MCP_ALLOWED_HOSTS}" ]; then
+    echo "WARN: MCP_ALLOWED_HOSTS not set for 0.0.0.0; using --disable-transport-security" >&2
+    set -- "$@" --disable-transport-security
+fi
+
+exec "$@"