mirror of
https://github.com/semantica-agi/semantica.git
synced 2026-08-29 04:26:20 +00:00
feat(plugins): add MCP server + 4 new plugin bundles (Windsurf, Cline, Continue, VS Code)
MCP Server (semantica/mcp_server.py): - Full stdio-based MCP server compatible with Claude Desktop, Windsurf, Cline, Continue, VS Code, Roo Code, and any MCP-aware tool - 12 tools: extract_entities, extract_relations, record_decision, query_decisions, find_precedents, get_causal_chain, add_entity, add_relationship, run_reasoning, get_graph_analytics, export_graph, get_graph_summary - 3 resources: semantica://graph/summary, semantica://decisions/list, semantica://schema/info - Lazy graph session with optional SEMANTICA_KG_PATH env var - JSON-RPC 2.0 over stdin/stdout; run with: python -m semantica.mcp_server New plugin bundles (each: plugin.json + marketplace.json + README.md): - plugins/.windsurf-plugin/ — Windsurf MCP config + 17 skills + 3 agents - plugins/.cline-plugin/ — Cline MCP config + 17 skills + 3 agents - plugins/.continue-plugin/ — Continue MCP config + 17 skills + 3 agents - plugins/.vscode-plugin/ — VS Code MCP config + 17 skills + 3 agents Updated plugins/.claude-plugin/README.md: - Platform support table expanded to 9 tools - Full MCP server section: per-tool config snippets for Claude Desktop, Windsurf, Cline, Continue, VS Code; tool/resource reference tables; environment variables Updated README.md: - Hero line updated to mention MCP server - Visual grid: Windsurf/VS Code/Cline/Continue → 'MCP server + plugin'; Claude Desktop → 'MCP server' - Plugin Bundles section: expanded table listing all 7 bundles with dirs - New MCP Server section with quick-start snippet and tool/resource list - Detailed integrations table: corrected connection types and config paths Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
KaifAhmad1
co-authored by
Claude Sonnet 4.6
Claude Sonnet 4.6
parent
f2eb3e1608
commit
ab93ec3e8f
@@ -2,13 +2,21 @@
|
||||
|
||||
Semantica ships a shared plugin bundle under `plugins/` with skills, agents, and hooks for knowledge graphs, context graphs, decision intelligence, reasoning, explainability, provenance, ontology, and export workflows.
|
||||
|
||||
This README is for community users who want to install or reuse the plugin package across Claude, Cursor, and Codex.
|
||||
This README covers installation across every supported platform.
|
||||
|
||||
## Supported Platforms
|
||||
|
||||
- Claude Code
|
||||
- Cursor
|
||||
- Codex
|
||||
| Platform | Method | Config file |
|
||||
|---|---|---|
|
||||
| Claude Code | Native plugin bundle | `plugins/.claude-plugin/plugin.json` |
|
||||
| Cursor | Native plugin bundle | `plugins/.cursor-plugin/plugin.json` |
|
||||
| Codex CLI | Native plugin bundle | `plugins/.codex-plugin/plugin.json` |
|
||||
| Windsurf | MCP server + plugin bundle | `plugins/.windsurf-plugin/plugin.json` |
|
||||
| Cline (VS Code) | MCP server + plugin bundle | `plugins/.cline-plugin/plugin.json` |
|
||||
| Continue | MCP server | `plugins/.continue-plugin/plugin.json` |
|
||||
| VS Code | MCP server | `plugins/.vscode-plugin/plugin.json` |
|
||||
| Claude Desktop | MCP server | — (see MCP section below) |
|
||||
| Any MCP client | MCP server | `python -m semantica.mcp_server` |
|
||||
|
||||
## Prerequisites
|
||||
|
||||
@@ -23,12 +31,16 @@ cd semantica
|
||||
|
||||
```text
|
||||
plugins/
|
||||
skills/
|
||||
agents/
|
||||
hooks/
|
||||
.claude-plugin/
|
||||
.cursor-plugin/
|
||||
.codex-plugin/
|
||||
skills/ ← 17 domain skills
|
||||
agents/ ← 3 specialized agents
|
||||
hooks/ ← hooks.json
|
||||
.claude-plugin/ ← Claude Code manifest
|
||||
.cursor-plugin/ ← Cursor manifest
|
||||
.codex-plugin/ ← Codex CLI manifest
|
||||
.windsurf-plugin/← Windsurf manifest + MCP config
|
||||
.cline-plugin/ ← Cline manifest + MCP config
|
||||
.continue-plugin/← Continue manifest + MCP config
|
||||
.vscode-plugin/ ← VS Code manifest + MCP config
|
||||
```
|
||||
|
||||
## Plugin Contents
|
||||
@@ -128,6 +140,114 @@ After installing on any platform, these are good smoke tests:
|
||||
4. `/semantica:explain decision <decision_id>`
|
||||
5. `/semantica:validate graph`
|
||||
|
||||
## MCP Server (Windsurf · Cline · Continue · VS Code · Claude Desktop · Any tool)
|
||||
|
||||
Semantica includes a full MCP server (`semantica/mcp_server.py`) that exposes 12 tools and 3 resources over stdio — compatible with any MCP-aware tool.
|
||||
|
||||
### Start the server
|
||||
|
||||
```bash
|
||||
python -m semantica.mcp_server
|
||||
```
|
||||
|
||||
### Configure in your tool
|
||||
|
||||
**Claude Desktop** — `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"semantica": {
|
||||
"command": "python",
|
||||
"args": ["-m", "semantica.mcp_server"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Windsurf** — `~/.codeium/windsurf/mcp_config.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"semantica": {
|
||||
"command": "python",
|
||||
"args": ["-m", "semantica.mcp_server"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Cline** — Cline MCP settings panel → Add server:
|
||||
|
||||
```json
|
||||
{
|
||||
"semantica": {
|
||||
"command": "python",
|
||||
"args": ["-m", "semantica.mcp_server"]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Continue** — `~/.continue/config.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": [
|
||||
{
|
||||
"name": "semantica",
|
||||
"command": "python",
|
||||
"args": ["-m", "semantica.mcp_server"]
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**VS Code** — `settings.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcp.servers": {
|
||||
"semantica": {
|
||||
"command": "python",
|
||||
"args": ["-m", "semantica.mcp_server"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Available MCP tools
|
||||
|
||||
| Tool | Description |
|
||||
|---|---|
|
||||
| `extract_entities` | Named entity recognition from text |
|
||||
| `extract_relations` | Relation and triplet extraction from text |
|
||||
| `record_decision` | Record a decision with full context and metadata |
|
||||
| `query_decisions` | Query recorded decisions by natural language or category |
|
||||
| `find_precedents` | Find past decisions similar to a scenario |
|
||||
| `get_causal_chain` | Trace upstream/downstream causal chain from a decision |
|
||||
| `add_entity` | Add a node/entity to the knowledge graph |
|
||||
| `add_relationship` | Add a directed edge between two entities |
|
||||
| `run_reasoning` | Run IF/THEN rules over facts to derive new facts |
|
||||
| `get_graph_analytics` | PageRank centrality and community detection |
|
||||
| `export_graph` | Export graph as Turtle, JSON-LD, N-Triples, or JSON |
|
||||
| `get_graph_summary` | Node count, decision count, graph status |
|
||||
|
||||
### Available MCP resources
|
||||
|
||||
| URI | Description |
|
||||
|---|---|
|
||||
| `semantica://graph/summary` | High-level graph statistics |
|
||||
| `semantica://decisions/list` | All recorded decisions |
|
||||
| `semantica://schema/info` | Server info and capability list |
|
||||
|
||||
### Environment variables
|
||||
|
||||
| Variable | Description |
|
||||
|---|---|
|
||||
| `SEMANTICA_KG_PATH` | Path to a persisted graph to load on start |
|
||||
| `SEMANTICA_LOG_LEVEL` | Log level: DEBUG, INFO, WARNING (default: WARNING) |
|
||||
|
||||
## Community Notes
|
||||
|
||||
- Keep plugin name/version/keywords updated in each manifest before publishing.
|
||||
|
||||
@@ -0,0 +1,24 @@
|
||||
# Semantica — Cline Plugin
|
||||
|
||||
Adds all 17 Semantica skills, 3 agents, and hook configuration to Cline (VS Code extension).
|
||||
|
||||
## MCP Server Setup (recommended)
|
||||
|
||||
In Cline settings, add a new MCP server:
|
||||
|
||||
```json
|
||||
{
|
||||
"semantica": {
|
||||
"command": "python",
|
||||
"args": ["-m", "semantica.mcp_server"],
|
||||
"env": {}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Cline will discover all 12 Semantica tools automatically on connection.
|
||||
|
||||
## Requirements
|
||||
|
||||
- Python 3.8+
|
||||
- `pip install semantica`
|
||||
@@ -0,0 +1,17 @@
|
||||
{
|
||||
"name": "semantica-cline",
|
||||
"plugins": [
|
||||
{
|
||||
"name": "semantica",
|
||||
"description": "Semantica plugin for Cline: knowledge graph skills, reasoning, extraction, and visualization.",
|
||||
"source": "./",
|
||||
"category": "Productivity",
|
||||
"tags": [
|
||||
"knowledge-graph",
|
||||
"reasoning",
|
||||
"semantica",
|
||||
"cline"
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,35 @@
|
||||
{
|
||||
"name": "semantica-cline",
|
||||
"displayName": "Semantica Cline Plugin",
|
||||
"description": "Semantica plugin for Cline: knowledge graph skills, decision intelligence, reasoning, extraction, and visualization.",
|
||||
"version": "0.1.0",
|
||||
"author": {
|
||||
"name": "Semantica Contributors"
|
||||
},
|
||||
"homepage": "https://github.com/Hawksight-AI/semantica",
|
||||
"repository": "https://github.com/Hawksight-AI/semantica",
|
||||
"license": "MIT",
|
||||
"keywords": [
|
||||
"semantica",
|
||||
"knowledge graph",
|
||||
"cline",
|
||||
"context graphs",
|
||||
"decision intelligence",
|
||||
"explainability",
|
||||
"causal analysis",
|
||||
"provenance",
|
||||
"ontology",
|
||||
"graph analytics",
|
||||
"semantic extraction",
|
||||
"visualization",
|
||||
"reasoning",
|
||||
"mcp"
|
||||
],
|
||||
"skills": "../skills",
|
||||
"agents": "../agents",
|
||||
"hooks": "../hooks/hooks.json",
|
||||
"mcp": {
|
||||
"server": "python -m semantica.mcp_server",
|
||||
"transport": "stdio"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,26 @@
|
||||
# Semantica — Continue Plugin
|
||||
|
||||
Adds Semantica as an MCP server and context provider to [Continue.dev](https://continue.dev).
|
||||
|
||||
## MCP Server Setup
|
||||
|
||||
Add to `~/.continue/config.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": [
|
||||
{
|
||||
"name": "semantica",
|
||||
"command": "python",
|
||||
"args": ["-m", "semantica.mcp_server"]
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
Continue will show all Semantica tools in the `@semantica` context provider dropdown.
|
||||
|
||||
## Requirements
|
||||
|
||||
- Python 3.8+
|
||||
- `pip install semantica`
|
||||
@@ -0,0 +1,17 @@
|
||||
{
|
||||
"name": "semantica-continue",
|
||||
"plugins": [
|
||||
{
|
||||
"name": "semantica",
|
||||
"description": "Semantica plugin for Continue.dev: knowledge graph context provider, reasoning, and extraction.",
|
||||
"source": "./",
|
||||
"category": "Productivity",
|
||||
"tags": [
|
||||
"knowledge-graph",
|
||||
"reasoning",
|
||||
"semantica",
|
||||
"continue"
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,33 @@
|
||||
{
|
||||
"name": "semantica-continue",
|
||||
"displayName": "Semantica Continue Plugin",
|
||||
"description": "Semantica plugin for Continue.dev: knowledge graph context provider, decision intelligence, reasoning, and semantic extraction.",
|
||||
"version": "0.1.0",
|
||||
"author": {
|
||||
"name": "Semantica Contributors"
|
||||
},
|
||||
"homepage": "https://github.com/Hawksight-AI/semantica",
|
||||
"repository": "https://github.com/Hawksight-AI/semantica",
|
||||
"license": "MIT",
|
||||
"keywords": [
|
||||
"semantica",
|
||||
"knowledge graph",
|
||||
"continue",
|
||||
"context provider",
|
||||
"decision intelligence",
|
||||
"explainability",
|
||||
"causal analysis",
|
||||
"provenance",
|
||||
"ontology",
|
||||
"semantic extraction",
|
||||
"reasoning",
|
||||
"mcp"
|
||||
],
|
||||
"skills": "../skills",
|
||||
"agents": "../agents",
|
||||
"hooks": "../hooks/hooks.json",
|
||||
"mcp": {
|
||||
"server": "python -m semantica.mcp_server",
|
||||
"transport": "stdio"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,36 @@
|
||||
# Semantica — VS Code Plugin
|
||||
|
||||
Adds Semantica as an MCP server to VS Code (via GitHub Copilot Chat or any MCP-aware extension).
|
||||
|
||||
## MCP Server Setup
|
||||
|
||||
Add to your VS Code `settings.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"github.copilot.chat.mcp.servers": {
|
||||
"semantica": {
|
||||
"command": "python",
|
||||
"args": ["-m", "semantica.mcp_server"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Or if using the VS Code MCP extension directly:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcp.servers": {
|
||||
"semantica": {
|
||||
"command": "python",
|
||||
"args": ["-m", "semantica.mcp_server"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Requirements
|
||||
|
||||
- Python 3.8+
|
||||
- `pip install semantica`
|
||||
@@ -0,0 +1,17 @@
|
||||
{
|
||||
"name": "semantica-vscode",
|
||||
"plugins": [
|
||||
{
|
||||
"name": "semantica",
|
||||
"description": "Semantica plugin for VS Code: knowledge graph skills, reasoning, extraction, and visualization.",
|
||||
"source": "./",
|
||||
"category": "Productivity",
|
||||
"tags": [
|
||||
"knowledge-graph",
|
||||
"reasoning",
|
||||
"semantica",
|
||||
"vscode"
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,35 @@
|
||||
{
|
||||
"name": "semantica-vscode",
|
||||
"displayName": "Semantica VS Code Plugin",
|
||||
"description": "Semantica plugin for VS Code: knowledge graph skills, decision intelligence, reasoning, extraction, and visualization via MCP server.",
|
||||
"version": "0.1.0",
|
||||
"author": {
|
||||
"name": "Semantica Contributors"
|
||||
},
|
||||
"homepage": "https://github.com/Hawksight-AI/semantica",
|
||||
"repository": "https://github.com/Hawksight-AI/semantica",
|
||||
"license": "MIT",
|
||||
"keywords": [
|
||||
"semantica",
|
||||
"knowledge graph",
|
||||
"vscode",
|
||||
"context graphs",
|
||||
"decision intelligence",
|
||||
"explainability",
|
||||
"causal analysis",
|
||||
"provenance",
|
||||
"ontology",
|
||||
"graph analytics",
|
||||
"semantic extraction",
|
||||
"visualization",
|
||||
"reasoning",
|
||||
"mcp"
|
||||
],
|
||||
"skills": "../skills",
|
||||
"agents": "../agents",
|
||||
"hooks": "../hooks/hooks.json",
|
||||
"mcp": {
|
||||
"server": "python -m semantica.mcp_server",
|
||||
"transport": "stdio"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,29 @@
|
||||
# Semantica — Windsurf Plugin
|
||||
|
||||
Adds all 17 Semantica skills, 3 agents, and hook configuration to Windsurf.
|
||||
|
||||
## MCP Server Setup (recommended)
|
||||
|
||||
Add to your Windsurf MCP config (`~/.codeium/windsurf/mcp_config.json`):
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"semantica": {
|
||||
"command": "python",
|
||||
"args": ["-m", "semantica.mcp_server"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Windsurf will then have access to all 12 Semantica tools (extract, record_decision, query_decisions, find_precedents, get_causal_chain, add_entity, add_relationship, run_reasoning, get_graph_analytics, export_graph, and more) directly in the AI panel.
|
||||
|
||||
## Skills
|
||||
|
||||
All 17 skills under `plugins/skills/` are available as slash commands once the plugin is loaded.
|
||||
|
||||
## Requirements
|
||||
|
||||
- Python 3.8+
|
||||
- `pip install semantica`
|
||||
@@ -0,0 +1,17 @@
|
||||
{
|
||||
"name": "semantica-windsurf",
|
||||
"plugins": [
|
||||
{
|
||||
"name": "semantica",
|
||||
"description": "Semantica plugin for Windsurf: knowledge graph skills, reasoning, extraction, and visualization.",
|
||||
"source": "./",
|
||||
"category": "Productivity",
|
||||
"tags": [
|
||||
"knowledge-graph",
|
||||
"reasoning",
|
||||
"semantica",
|
||||
"windsurf"
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,35 @@
|
||||
{
|
||||
"name": "semantica-windsurf",
|
||||
"displayName": "Semantica Windsurf Plugin",
|
||||
"description": "Semantica plugin for Windsurf: knowledge graph skills, decision intelligence, reasoning, extraction, and visualization.",
|
||||
"version": "0.1.0",
|
||||
"author": {
|
||||
"name": "Semantica Contributors"
|
||||
},
|
||||
"homepage": "https://github.com/Hawksight-AI/semantica",
|
||||
"repository": "https://github.com/Hawksight-AI/semantica",
|
||||
"license": "MIT",
|
||||
"keywords": [
|
||||
"semantica",
|
||||
"knowledge graph",
|
||||
"windsurf",
|
||||
"context graphs",
|
||||
"decision intelligence",
|
||||
"explainability",
|
||||
"causal analysis",
|
||||
"provenance",
|
||||
"ontology",
|
||||
"graph analytics",
|
||||
"semantic extraction",
|
||||
"visualization",
|
||||
"reasoning",
|
||||
"mcp"
|
||||
],
|
||||
"skills": "../skills",
|
||||
"agents": "../agents",
|
||||
"hooks": "../hooks/hooks.json",
|
||||
"mcp": {
|
||||
"server": "python -m semantica.mcp_server",
|
||||
"transport": "stdio"
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user