LearnNewsExamplesServices
Frontmatter
id7399
titleArchitect AI Tooling as a Model Context Protocol (MCP) Servers
stateClosed
labels
help wantedgood first issueepichacktoberfestai
assigneestobiu
createdAtOct 7, 2025, 11:26 AM
updatedAtOct 24, 2025, 11:27 AM
githubUrlhttps://github.com/neomjs/neo/issues/7399
authortobiu
commentsCount2
parentIssuenull
subIssues
7400 Define Agent-Agnostic MCP Server Configuration
7401 Design Knowledge Base MCP Server API
7402 Design Memory Core MCP Server API
7403 MCP Server: Implement Knowledge Server Scaffold
7404 MCP Server: Implement Knowledge Read Endpoints
7406 MCP Server: Implement Knowledge Admin Endpoints
7407 MCP Server: Implement Memory Server Scaffold
7408 MCP Server: Implement Memory Read Endpoints
7409 MCP Server: Implement Memory Query Endpoints
7410 MCP Server: Implement Memory Create Endpoint
7411 MCP Server: Implement Memory Lifecycle Endpoints
7412 MCP Server: Implement Memory Admin Endpoints
7425 MCP Config: Align Knowledge Server Port and Health Check
7464 MCP Server: Refine Memory Server Endpoints
7468 MCP Server: Relocate Memory API Specification
subIssuesCompleted15
subIssuesTotal15
blockedBy[]
blocking[]
closedAtOct 24, 2025, 11:27 AM

Architect AI Tooling as a Model Context Protocol (MCP) Servers

Closed v11.0.0 help wantedgood first issueepichacktoberfestai
tobiu
tobiu commented on Oct 7, 2025, 11:26 AM

This epic outlines the architectural initiative to transform our current shell-based AI tools (for the knowledge base and memory core) into a formal, robust, and agent-agnostic Model Context Protocol (MCP) server architecture.

The current approach, which relies on agents executing npm run scripts and parsing stdout, is brittle, inefficient, and creates platform-specific challenges (e.g., shell quoting). Migrating to a dedicated MCP server architecture will provide a stable, structured API for AI interaction, significantly improving reliability and simplifying agent instructions.

A key goal is to ensure this new architecture is agent-agnostic, allowing different AI models (e.g., from Google, Anthropic) to consume these tools through a standardized configuration, rather than being tied to a specific vendor's settings file (like .gemini/settings.json).

This epic (the subs) fit the Hacktoberfest scope very well. Please read our event intro epic first: https://github.com/neomjs/neo/issues/7296

For contributors unfamiliar with the Model Context Protocol, the following official resources are highly recommended:

The subs require our new "AI Native" workflow, and big parts can get resolved by navigating agents. For getting up to speed, please read: https://github.com/neomjs/neo/blob/dev/.github/WORKING_WITH_AGENTS.md https://github.com/neomjs/neo/blob/dev/.github/AI_QUICK_START.md

Since the epic subs strongly build on and relate to each other, I also strongly recommend joining the Slack and / or Discord Channels, so that you guys can sync.

https://join.slack.com/t/neomjs/shared_invite/zt-6c50ueeu-3E1~M4T9xkNnb~M_prEEOA https://discord.gg/6p8paPq

[Update] The "big picture" of all the current epics is mostly related to context engineering: https://github.com/neomjs/neo/blob/dev/ROADMAP.md https://github.com/neomjs/neo/blob/dev/.github/VISION.md

Sub-Tasks

Phase 1: Design & Foundation

  • Done: ticket-define-agent-agnostic-mcp-config.md
  • To Do: ticket-design-knowledge-mcp-api.md
  • Done: ticket-design-memory-mcp-api.md
  • Done: ticket-mcp-config-align-knowledge-server.md

Phase 2: Implementation

  • To Do: ticket-implement-knowledge-server-scaffold.md
  • To Do: ticket-implement-knowledge-read-endpoints.md
  • To Do: ticket-implement-knowledge-query-endpoint.md
  • To Do: ticket-implement-knowledge-admin-endpoints.md
  • Done: ticket-implement-memory-server-scaffold.md
  • Done: ticket-implement-memory-read-endpoints.md
  • Done: ticket-implement-memory-query-endpoints.md
  • To Do: ticket-implement-memory-create-endpoint.md
  • To Do: ticket-implement-memory-lifecycle-endpoints.md
  • To Do: ticket-implement-memory-admin-endpoints.md
  • To Do: ticket-refine-memory-server-endpoints.md

Phase 3: Integration & Documentation

  • Done: ticket-relocate-memory-api-spec.md
  • To Do: ticket-update-agents-md-for-mcp.md
  • To Do: ticket-create-mcp-server-documentation.md
  • To Do: ticket-cleanup-old-ai-query-npm-scripts.md
tobiu assigned to @tobiu on Oct 7, 2025, 11:26 AM
tobiu added the epic label on Oct 7, 2025, 11:26 AM
tobiu added the ai label on Oct 7, 2025, 11:26 AM
tobiu referenced in commit 59a9701 - "#7399 internal ticket files WIP" on Oct 7, 2025, 11:26 AM
tobiu added sub-issue #7400 on Oct 7, 2025, 11:45 AM
tobiu cross-referenced by #7400 on Oct 7, 2025, 12:01 PM
tobiu added sub-issue #7401 on Oct 7, 2025, 12:05 PM
tobiu added the help wanted label on Oct 7, 2025, 12:06 PM
tobiu added the good first issue label on Oct 7, 2025, 12:06 PM
tobiu added the hacktoberfest label on Oct 7, 2025, 12:06 PM
tobiu added sub-issue #7402 on Oct 7, 2025, 12:08 PM
tobiu added sub-issue #7403 on Oct 7, 2025, 12:10 PM
tobiu added sub-issue #7404 on Oct 7, 2025, 12:12 PM
tobiu added sub-issue #7405 on Oct 7, 2025, 12:14 PM
tobiu added sub-issue #7406 on Oct 7, 2025, 12:17 PM
tobiu added sub-issue #7407 on Oct 7, 2025, 12:19 PM
tobiu added sub-issue #7408 on Oct 7, 2025, 12:21 PM
tobiu added sub-issue #7409 on Oct 7, 2025, 12:24 PM
tobiu added sub-issue #7410 on Oct 7, 2025, 12:26 PM
tobiu added sub-issue #7411 on Oct 7, 2025, 12:29 PM
tobiu added sub-issue #7412 on Oct 7, 2025, 12:30 PM
tobiu referenced in commit 398d1b0 - "#7399 internal ticket md files" on Oct 7, 2025, 12:31 PM
tobiu cross-referenced by #7408 on Oct 7, 2025, 12:45 PM
tobiu added sub-issue #7413 on Oct 7, 2025, 12:48 PM
tobiu referenced in commit d5c5e05 - "#7399 MCP Server: Implement Knowledge Create/Update Endpoint sub" on Oct 7, 2025, 12:48 PM
tobiu removed sub-issue #7413 on Oct 7, 2025, 12:52 PM
tobiu referenced in commit 396ddf0 - "#7399 ticket polishing" on Oct 7, 2025, 12:58 PM
tobiu cross-referenced by #7403 on Oct 7, 2025, 6:30 PM
tobiu cross-referenced by #7401 on Oct 8, 2025, 11:32 AM
tobiu cross-referenced by #7410 on Oct 8, 2025, 11:35 AM
MannXo cross-referenced by #7404 on Oct 8, 2025, 2:12 PM
tobiu cross-referenced by #7283 on Oct 8, 2025, 2:37 PM
tobiu referenced in commit 560d280 - "#7399 minor sub changes, for a better new file location" on Oct 8, 2025, 4:47 PM
tobiu
tobiu Oct 8, 2025, 5:22 PM

FYI: https://geminicli.com/extensions/

=> while this is limited to gemini, it is definitely worth to brainstorm about it.

✦ Here is my new analysis based on the actual content:

  1. The Goal is to Build "Extensions": You are correct. The entire initiative is about creating Gemini CLI Extensions. The geminicli.comite positions these as the primary way to integrate tools and personalize the CLI. Our Knowledge Base and Memory Core servers are not just standalone projects; they are features to be packaged as extensions for this ecosystem.

  2. Anatomy of an Extension: The main page clarifies that an extension is a bundle that can contain MCP servers, context files, and custom commands. This is a key insight. While MCP is the dominant mechanism, as seen on the browse page, an extension is a broader concept. This means for our epics, we need to consider if we only need an MCP server, or if we should also provide context files or custom commands to make the user experience better.

  3. A Rich Ecosystem: The browse page shows a mature ecosystem with extensions for major platforms like Stripe, Terraform, Grafana, and many Google Cloud services. The chrome-devtools-mcp extension is listed at the top, which firmly places our own DevTools integration work within this same strategic direction.

This new context is extremely valuable. It reframes the goal of the epic-architect-ai-tooling-as-mcp.md epic. We are not just refactoring scripts into servers; we are building full-fledged extensions for a specific, documented platform. The "Build your own" section mentioned on the main page will be a critical resource for our scaffolding tickets, as it will define what a complete, well-formed extension looks like.

Thank you for this essential context update.

tobiu cross-referenced by PR #7419 on Oct 8, 2025, 5:36 PM
tobiu cross-referenced by #7407 on Oct 8, 2025, 5:56 PM
tobiu cross-referenced by #7406 on Oct 8, 2025, 6:31 PM
tobiu added sub-issue #7425 on Oct 9, 2025, 12:25 PM
tobiu cross-referenced by #7409 on Oct 10, 2025, 4:10 PM
tobiu added sub-issue #7464 on Oct 11, 2025, 8:03 PM
tobiu added sub-issue #7468 on Oct 12, 2025, 1:17 PM
tobiu referenced in commit 68c7980 - "#7399 sub-tasks cleanup" on Oct 12, 2025, 1:20 PM
tobiu removed sub-issue #7405 on Oct 24, 2025, 11:26 AM
tobiu
tobiu Oct 24, 2025, 11:27 AM

resolved => inside the new servers

tobiu closed this issue on Oct 24, 2025, 11:27 AM