feat: Add MCP server stubs, development docs, and Docker updates

- Add MCP server skeleton implementations for all 7 planned servers
  (llm-gateway, knowledge-base, git, issues, filesystem, code-analysis, cicd)
- Add comprehensive DEVELOPMENT.md with setup and usage instructions
- Add BACKLOG.md with detailed phase planning
- Update docker-compose.dev.yml with Redis and Celery workers
- Update CLAUDE.md with Syndarix-specific context

Addresses issues #16, #20, #21

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
2025-12-30 02:13:16 +01:00
parent 2f7124959d
commit 2310c8cdfd
19 changed files with 3060 additions and 2 deletions

View File

@@ -0,0 +1,23 @@
[project]
name = "syndarix-mcp-issues"
version = "0.1.0"
description = "Syndarix Issues MCP Server - Issue tracker synchronization"
requires-python = ">=3.12"
dependencies = [
"fastmcp>=0.1.0",
"httpx>=0.27.0",
"redis>=5.0.0",
"pydantic>=2.0.0",
"pydantic-settings>=2.0.0",
]
[project.optional-dependencies]
dev = [
"pytest>=8.0.0",
"pytest-asyncio>=0.23.0",
"ruff>=0.8.0",
]
[tool.ruff]
target-version = "py312"
line-length = 88

View File

@@ -0,0 +1,76 @@
"""
Syndarix Issues MCP Server.
Provides issue tracker operations with:
- Multi-provider support (Gitea, GitHub, GitLab)
- Bi-directional sync
- LWW conflict resolution
Per ADR-011: Issue Synchronization.
"""
import os
from fastmcp import FastMCP
mcp = FastMCP(
"syndarix-issues",
description="Issue tracker synchronization",
)
@mcp.tool()
async def list_issues(
project_id: str,
state: str = "open",
labels: list[str] | None = None,
) -> dict:
"""List issues for a project."""
return {"status": "not_implemented", "project_id": project_id}
@mcp.tool()
async def get_issue(project_id: str, issue_id: str) -> dict:
"""Get a specific issue."""
return {"status": "not_implemented", "project_id": project_id}
@mcp.tool()
async def create_issue(
project_id: str,
title: str,
body: str,
labels: list[str] | None = None,
assignees: list[str] | None = None,
) -> dict:
"""Create a new issue."""
return {"status": "not_implemented", "project_id": project_id}
@mcp.tool()
async def update_issue(
project_id: str,
issue_id: str,
title: str | None = None,
body: str | None = None,
state: str | None = None,
labels: list[str] | None = None,
) -> dict:
"""Update an existing issue."""
return {"status": "not_implemented", "project_id": project_id}
@mcp.tool()
async def add_comment(project_id: str, issue_id: str, body: str) -> dict:
"""Add a comment to an issue."""
return {"status": "not_implemented", "project_id": project_id}
@mcp.tool()
async def sync_issues(project_id: str, full: bool = False) -> dict:
"""Trigger issue sync for a project."""
return {"status": "not_implemented", "project_id": project_id}
if __name__ == "__main__":
mcp.run()