synapse-mcp 1.0.0__tar.gz

synapse_mcp-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ankechenlab-node
+
+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.

synapse_mcp-1.0.0/PKG-INFO

@@ -0,0 +1,269 @@
+Metadata-Version: 2.4
+Name: synapse-mcp
+Version: 1.0.0
+Summary: Universal MCP server for code development pipeline and knowledge management
+Author-email: ankechenlab-node <ankechenlab@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/ankechenlab-node/synapse-mcp
+Project-URL: Repository, https://github.com/ankechenlab-node/synapse-mcp
+Project-URL: Issues, https://github.com/ankechenlab-node/synapse-mcp/issues
+Keywords: mcp,code-generation,knowledge-base,pipeline,synapse
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastmcp>=2.0.0
+Dynamic: license-file
+
+# Synapse MCP
+
+Universal MCP server for code development pipeline and knowledge management.
+
+通用 MCP 服务器，一体化完成代码开发流水线与知识管理。
+
+---
+
+[English](#english) | [中文](#chinese)
+
+---
+
+## English
+
+### Features
+
+**Session Management** — Create, track, and archive development sessions across projects.
+
+**Pipeline Execution** — Multi-stage code delivery pipeline (REQ → ARCH → DEV → INT → QA → DEPLOY) with real-time progress reporting via MCP Tasks API.
+
+**Knowledge Management** — Initialize wikis, ingest content, query knowledge, and run health checks.
+
+**URI Resources** — Direct access to wiki pages and session state via `wiki://`, `state://`, `log://` URIs.
+
+**Prompt Templates** — Built-in templates for pipeline stages and wiki pages.
+
+### Quick Start
+
+#### Via uv (recommended)
+
+```bash
+uvx synapse-mcp
+```
+
+#### Via pip
+
+```bash
+pip install synapse-mcp
+python -m synapse_mcp.server
+```
+
+### Client Configuration
+
+**Claude Desktop / Cursor / Windsurf**
+
+```json
+{
+  "mcpServers": {
+    "synapse": {
+      "command": "uv",
+      "args": ["run", "--from", "synapse-mcp", "synapse-mcp-server"]
+    }
+  }
+}
+```
+
+**Claude Code**
+
+```bash
+claude mcp add synapse -- uv run --from synapse-mcp synapse-mcp-server
+```
+
+**HTTP Transport (remote)**
+
+```bash
+python -m synapse_mcp.server --transport http --port 8000
+```
+
+### MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `session_create` | Create a new development session |
+| `session_status` | Check session progress and tasks |
+| `session_list` | List all sessions |
+| `session_save` | Force-save session state |
+| `session_archive` | Archive a completed session |
+| `pipeline_run` | Execute pipeline stages with progress |
+| `pipeline_status` | Check pipeline run status |
+| `pipeline_stages` | List available pipeline stages |
+| `wiki_init` | Initialize a wiki knowledge base |
+| `wiki_ingest` | Ingest content into wiki |
+| `wiki_query` | Query wiki with natural language |
+| `wiki_lint` | Run wiki health check |
+
+### MCP Resources
+
+| URI Pattern | Description |
+|-------------|-------------|
+| `wiki://{path}` | Read wiki page (e.g., `wiki://CLAUDE.md`) |
+| `state://{project}` | Read session state JSON |
+| `log://{project}` | Read session activity log |
+
+### MCP Prompts
+
+| Prompt | Description |
+|--------|-------------|
+| `pipeline_template` | Get prompt for pipeline stage (REQ/ARCH/DEV/INT/QA) |
+| `wiki_page_template` | Get template for wiki page (concept/decision/guide) |
+
+### Architecture
+
+```
+┌─────────────────────────────────────┐
+│        MCP Client (any host)         │
+│  Claude Desktop / Cursor / Claude Code│
+└──────────────┬──────────────────────┘
+               │ stdio / http
+               ▼
+┌─────────────────────────────────────┐
+│       Synapse MCP Server             │
+│  Tools: session/pipeline/wiki        │
+│  Resources: wiki:// state:// log://  │
+│  Prompts: pipeline/wiki templates    │
+│  State: ~/.synapse/ (persistent)     │
+└──────────────┬──────────────────────┘
+               │
+      ┌────────┼────────┐
+      ▼        ▼        ▼
+  Pipeline   Wiki    State (JSON)
+```
+
+---
+
+## 中文
+
+### 功能特性
+
+**会话管理** — 创建、追踪和归档跨项目的开发会话状态。
+
+**流水线执行** — 多阶段代码交付流水线（REQ → ARCH → DEV → INT → QA → DEPLOY），通过 MCP Tasks API 实时报告进度。
+
+**知识管理** — 初始化知识库、摄取内容、智能查询、健康检查。
+
+**URI 资源** — 通过 `wiki://`、`state://`、`log://` URI 直接访问 wiki 页面和会话状态。
+
+**提示词模板** — 内置流水线阶段和 wiki 页面的提示词模板。
+
+### 快速开始
+
+#### 使用 uv（推荐）
+
+```bash
+uvx synapse-mcp
+```
+
+#### 使用 pip
+
+```bash
+pip install synapse-mcp
+python -m synapse_mcp.server
+```
+
+### 客户端配置
+
+**Claude Desktop / Cursor / Windsurf**
+
+```json
+{
+  "mcpServers": {
+    "synapse": {
+      "command": "uv",
+      "args": ["run", "--from", "synapse-mcp", "synapse-mcp-server"]
+    }
+  }
+}
+```
+
+**Claude Code**
+
+```bash
+claude mcp add synapse -- uv run --from synapse-mcp synapse-mcp-server
+```
+
+**HTTP 传输（远程模式）**
+
+```bash
+python -m synapse_mcp.server --transport http --port 8000
+```
+
+### MCP 工具
+
+| 工具 | 说明 |
+|------|------|
+| `session_create` | 创建新的开发会话 |
+| `session_status` | 查看会话进度和任务 |
+| `session_list` | 列出所有会话 |
+| `session_save` | 强制保存会话状态 |
+| `session_archive` | 归档已完成的会话 |
+| `pipeline_run` | 执行流水线阶段，带进度报告 |
+| `pipeline_status` | 查看流水线运行状态 |
+| `pipeline_stages` | 列出可用的流水线阶段 |
+| `wiki_init` | 初始化知识库 |
+| `wiki_ingest` | 摄取内容到知识库 |
+| `wiki_query` | 自然语言查询知识库 |
+| `wiki_lint` | 知识库健康检查 |
+
+### MCP 资源
+
+| URI 模式 | 说明 |
+|---------|------|
+| `wiki://{路径}` | 读取 wiki 页面（如 `wiki://CLAUDE.md`） |
+| `state://{项目}` | 读取会话状态 JSON |
+| `log://{项目}` | 读取会话活动日志 |
+
+### MCP 提示词
+
+| 提示词 | 说明 |
+|--------|------|
+| `pipeline_template` | 获取流水线阶段提示词（REQ/ARCH/DEV/INT/QA） |
+| `wiki_page_template` | 获取 wiki 页面模板（concept/decision/guide） |
+
+### 架构
+
+```
+┌─────────────────────────────────────┐
+│        MCP 客户端（任意宿主）          │
+│  Claude Desktop / Cursor / Claude Code│
+└──────────────┬──────────────────────┘
+               │ stdio / http
+               ▼
+┌─────────────────────────────────────┐
+│       Synapse MCP Server             │
+│  Tools: session/pipeline/wiki        │
+│  Resources: wiki:// state:// log://  │
+│  Prompts: pipeline/wiki 模板          │
+│  State: ~/.synapse/（持久化）         │
+└──────────────┬──────────────────────┘
+               │
+      ┌────────┼────────┐
+      ▼        ▼        ▼
+  Pipeline   Wiki    State (JSON)
+```
+
+---
+
+## Related Projects / 相关项目
+
+- [synapse-brain](https://github.com/ankechenlab-node/synapse-brain) — OpenClaw 持久化编排代理
+- [synapse-code](https://github.com/ankechenlab-node/synapse-code) — 智能代码开发工作流引擎
+- [synapse-wiki](https://github.com/ankechenlab-node/synapse-wiki) — 智能知识库管理系统
+
+## License
+
+MIT

synapse_mcp-1.0.0/README.md

@@ -0,0 +1,245 @@
+# Synapse MCP
+
+Universal MCP server for code development pipeline and knowledge management.
+
+通用 MCP 服务器，一体化完成代码开发流水线与知识管理。
+
+---
+
+[English](#english) | [中文](#chinese)
+
+---
+
+## English
+
+### Features
+
+**Session Management** — Create, track, and archive development sessions across projects.
+
+**Pipeline Execution** — Multi-stage code delivery pipeline (REQ → ARCH → DEV → INT → QA → DEPLOY) with real-time progress reporting via MCP Tasks API.
+
+**Knowledge Management** — Initialize wikis, ingest content, query knowledge, and run health checks.
+
+**URI Resources** — Direct access to wiki pages and session state via `wiki://`, `state://`, `log://` URIs.
+
+**Prompt Templates** — Built-in templates for pipeline stages and wiki pages.
+
+### Quick Start
+
+#### Via uv (recommended)
+
+```bash
+uvx synapse-mcp
+```
+
+#### Via pip
+
+```bash
+pip install synapse-mcp
+python -m synapse_mcp.server
+```
+
+### Client Configuration
+
+**Claude Desktop / Cursor / Windsurf**
+
+```json
+{
+  "mcpServers": {
+    "synapse": {
+      "command": "uv",
+      "args": ["run", "--from", "synapse-mcp", "synapse-mcp-server"]
+    }
+  }
+}
+```
+
+**Claude Code**
+
+```bash
+claude mcp add synapse -- uv run --from synapse-mcp synapse-mcp-server
+```
+
+**HTTP Transport (remote)**
+
+```bash
+python -m synapse_mcp.server --transport http --port 8000
+```
+
+### MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `session_create` | Create a new development session |
+| `session_status` | Check session progress and tasks |
+| `session_list` | List all sessions |
+| `session_save` | Force-save session state |
+| `session_archive` | Archive a completed session |
+| `pipeline_run` | Execute pipeline stages with progress |
+| `pipeline_status` | Check pipeline run status |
+| `pipeline_stages` | List available pipeline stages |
+| `wiki_init` | Initialize a wiki knowledge base |
+| `wiki_ingest` | Ingest content into wiki |
+| `wiki_query` | Query wiki with natural language |
+| `wiki_lint` | Run wiki health check |
+
+### MCP Resources
+
+| URI Pattern | Description |
+|-------------|-------------|
+| `wiki://{path}` | Read wiki page (e.g., `wiki://CLAUDE.md`) |
+| `state://{project}` | Read session state JSON |
+| `log://{project}` | Read session activity log |
+
+### MCP Prompts
+
+| Prompt | Description |
+|--------|-------------|
+| `pipeline_template` | Get prompt for pipeline stage (REQ/ARCH/DEV/INT/QA) |
+| `wiki_page_template` | Get template for wiki page (concept/decision/guide) |
+
+### Architecture
+
+```
+┌─────────────────────────────────────┐
+│        MCP Client (any host)         │
+│  Claude Desktop / Cursor / Claude Code│
+└──────────────┬──────────────────────┘
+               │ stdio / http
+               ▼
+┌─────────────────────────────────────┐
+│       Synapse MCP Server             │
+│  Tools: session/pipeline/wiki        │
+│  Resources: wiki:// state:// log://  │
+│  Prompts: pipeline/wiki templates    │
+│  State: ~/.synapse/ (persistent)     │
+└──────────────┬──────────────────────┘
+               │
+      ┌────────┼────────┐
+      ▼        ▼        ▼
+  Pipeline   Wiki    State (JSON)
+```
+
+---
+
+## 中文
+
+### 功能特性
+
+**会话管理** — 创建、追踪和归档跨项目的开发会话状态。
+
+**流水线执行** — 多阶段代码交付流水线（REQ → ARCH → DEV → INT → QA → DEPLOY），通过 MCP Tasks API 实时报告进度。
+
+**知识管理** — 初始化知识库、摄取内容、智能查询、健康检查。
+
+**URI 资源** — 通过 `wiki://`、`state://`、`log://` URI 直接访问 wiki 页面和会话状态。
+
+**提示词模板** — 内置流水线阶段和 wiki 页面的提示词模板。
+
+### 快速开始
+
+#### 使用 uv（推荐）
+
+```bash
+uvx synapse-mcp
+```
+
+#### 使用 pip
+
+```bash
+pip install synapse-mcp
+python -m synapse_mcp.server
+```
+
+### 客户端配置
+
+**Claude Desktop / Cursor / Windsurf**
+
+```json
+{
+  "mcpServers": {
+    "synapse": {
+      "command": "uv",
+      "args": ["run", "--from", "synapse-mcp", "synapse-mcp-server"]
+    }
+  }
+}
+```
+
+**Claude Code**
+
+```bash
+claude mcp add synapse -- uv run --from synapse-mcp synapse-mcp-server
+```
+
+**HTTP 传输（远程模式）**
+
+```bash
+python -m synapse_mcp.server --transport http --port 8000
+```
+
+### MCP 工具
+
+| 工具 | 说明 |
+|------|------|
+| `session_create` | 创建新的开发会话 |
+| `session_status` | 查看会话进度和任务 |
+| `session_list` | 列出所有会话 |
+| `session_save` | 强制保存会话状态 |
+| `session_archive` | 归档已完成的会话 |
+| `pipeline_run` | 执行流水线阶段，带进度报告 |
+| `pipeline_status` | 查看流水线运行状态 |
+| `pipeline_stages` | 列出可用的流水线阶段 |
+| `wiki_init` | 初始化知识库 |
+| `wiki_ingest` | 摄取内容到知识库 |
+| `wiki_query` | 自然语言查询知识库 |
+| `wiki_lint` | 知识库健康检查 |
+
+### MCP 资源
+
+| URI 模式 | 说明 |
+|---------|------|
+| `wiki://{路径}` | 读取 wiki 页面（如 `wiki://CLAUDE.md`） |
+| `state://{项目}` | 读取会话状态 JSON |
+| `log://{项目}` | 读取会话活动日志 |
+
+### MCP 提示词
+
+| 提示词 | 说明 |
+|--------|------|
+| `pipeline_template` | 获取流水线阶段提示词（REQ/ARCH/DEV/INT/QA） |
+| `wiki_page_template` | 获取 wiki 页面模板（concept/decision/guide） |
+
+### 架构
+
+```
+┌─────────────────────────────────────┐
+│        MCP 客户端（任意宿主）          │
+│  Claude Desktop / Cursor / Claude Code│
+└──────────────┬──────────────────────┘
+               │ stdio / http
+               ▼
+┌─────────────────────────────────────┐
+│       Synapse MCP Server             │
+│  Tools: session/pipeline/wiki        │
+│  Resources: wiki:// state:// log://  │
+│  Prompts: pipeline/wiki 模板          │
+│  State: ~/.synapse/（持久化）         │
+└──────────────┬──────────────────────┘
+               │
+      ┌────────┼────────┐
+      ▼        ▼        ▼
+  Pipeline   Wiki    State (JSON)
+```
+
+---
+
+## Related Projects / 相关项目
+
+- [synapse-brain](https://github.com/ankechenlab-node/synapse-brain) — OpenClaw 持久化编排代理
+- [synapse-code](https://github.com/ankechenlab-node/synapse-code) — 智能代码开发工作流引擎
+- [synapse-wiki](https://github.com/ankechenlab-node/synapse-wiki) — 智能知识库管理系统
+
+## License
+
+MIT

synapse_mcp-1.0.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "synapse-mcp"
+version = "1.0.0"
+description = "Universal MCP server for code development pipeline and knowledge management"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.12"
+authors = [
+    {name = "ankechenlab-node", email = "ankechenlab@gmail.com"},
+]
+keywords = ["mcp", "code-generation", "knowledge-base", "pipeline", "synapse"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Code Generators",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "fastmcp>=2.0.0",
+]
+
+[project.scripts]
+synapse-mcp-server = "synapse_mcp.server:main"
+
+[project.urls]
+Homepage = "https://github.com/ankechenlab-node/synapse-mcp"
+Repository = "https://github.com/ankechenlab-node/synapse-mcp"
+Issues = "https://github.com/ankechenlab-node/synapse-mcp/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]

synapse_mcp-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

synapse_mcp-1.0.0/src/synapse_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""Synapse MCP — Universal MCP server for code development & knowledge management."""
+
+__version__ = "1.0.0"

synapse_mcp-1.0.0/src/synapse_mcp/prompts/__init__.py

@@ -0,0 +1 @@
+"""MCP Prompts for Synapse."""