Skip to content

feat: Add MCP Server integration for agency agents#518

Open
shenshuoyaoyouguang wants to merge 4 commits into
msitarzewski:mainfrom
shenshuoyaoyouguang:feat/add-mcp-server-integration
Open

feat: Add MCP Server integration for agency agents#518
shenshuoyaoyouguang wants to merge 4 commits into
msitarzewski:mainfrom
shenshuoyaoyouguang:feat/add-mcp-server-integration

Conversation

@shenshuoyaoyouguang
Copy link
Copy Markdown

Summary

This PR adds a complete MCP (Model Context Protocol) Server integration, enabling IDE tools to interact with agency agents via the MCP protocol.

Changes

New: MCP Server Implementation (mcp-server/)

  • TypeScript MCP server with full agent interaction capabilities
    • src/index.ts - Server entry point
    • src/loader.ts - Agent file loader
    • src/nexus.ts - Nexus orchestration pipeline
    • src/types.ts and src/utils.ts - Shared types and utilities
  • MCP Tools: invoke-agent, list-agents, orchestrate
  • MCP Prompts: agent-activate, nexus-pipeline
  • MCP Resources: agent-profile
  • Build and config: package.json, tsconfig.json, smoke-test.mjs

New: Integration Support

  • integrations/mcp-server/README.md - MCP Server integration documentation
  • scripts/common.sh - Shared shell utilities (normalize_node_entry_path)

Modified: Tool Integration Scripts

  • scripts/convert.sh - Added mcp-server and trae as supported conversion targets
    • Generates IDE-specific MCP config files (Trae, Cursor, Claude)
    • Added to parallel conversion pipeline
  • scripts/install.sh - Added mcp-server and trae installation support
    • Auto-detects Node.js 18+ for MCP server compatibility
    • Installs npm dependencies and builds automatically if needed
    • Creates IDE-specific MCP config files (Trae, Cursor, Claude Desktop)
    • Safe: skips if existing config files are found

Modified: Other Files

  • .gitignore - Added MCP Server build artifacts, IDE MCP config files, trae rules, fixed .omx/ ignore pattern
  • README.md - Added MCP Server to supported tools list
  • specialized/zk-steward.md - Fixed description field quoting for YAML frontmatter compatibility

Testing

  • MCP server builds successfully with npm run build
  • Install script detects Node.js 18+ and generates correct config files
  • Convert script generates valid MCP config JSON for all supported IDEs

Files Changed (23 files, +3905 / -8 lines)

chujian added 4 commits May 9, 2026 08:06
- Add complete MCP (Model Context Protocol) server implementation in TypeScript
  - Server entry point, agent loader, nexus orchestration pipeline
  - Tools: invoke-agent, list-agents, orchestrate
  - Prompts: agent-activate, nexus-pipeline
  - Resources: agent-profile
- Add mcp-server as a supported tool in convert.sh and install.sh
  - Auto-detect Node.js 18+ for MCP server compatibility
  - Generate IDE-specific MCP config files (Trae, Cursor, Claude Desktop)
  - Install dependencies and build automatically if needed
- Add scripts/common.sh with shared shell utilities (normalize_node_entry_path)
- Update .gitignore for MCP server build artifacts and IDE config files
- Fix .omx/ ignore pattern to properly exclude subdirectories
- Update README.md to include MCP Server in supported tools list
- Fix zk-steward.md description field quoting for YAML compatibility
- loader.ts: remove unused 'cat' variable, iterate byCategory.values() directly
- index.ts: replace hardcoded category enum with AGENT_DIRS constant
- invoke-agent.ts: use slugify() for multi-word query matching in suggestions
- smoke-test.mjs: replace fragile exact count assertion with functional checks
- nexus.ts: use word-boundary regex for keyword matching, handle terminal phase handoff
- utils.ts: improve resolveRepoRoot fallback with logging and process.cwd()
- install.sh: remove 'trae' from ALL_TOOLS (no implementation yet)
- convert.sh: remove 'trae' from valid_tools/tools_to_run/parallel_tools
- docs/mcp-server-development-plan.md: add 'text' language tags to fenced code blocks (MD040)
- integrations/mcp-server/README.md: add 'text' language tag to usage example block (MD040)
- README.md: add MCP Server entry to Multi-Tool Integrations section
将 slugify 函数从 loader.ts 模块中导出,以便 invoke-agent.ts 可以导入并使用该函数。同时更新 install.sh 脚本中的工具列表,添加 trae 工具。
@bensl84
Copy link
Copy Markdown

bensl84 commented May 20, 2026

Closing — this is my personal fork (bensl84/agency-agents). The canonical project lives at https://github.com/msitarzewski/agency-agents — please re-open your PR there. Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants