SM-Assistant MCP Server (基于 FastMCP 的多域工具服务器)
使用说明(Markdown格式)
-
项目简介
- 该仓库中存在基于 MCP(Model Context Protocol)的服务器端实现,核心通过 FastMCP 等组件搭建,支持多域工具的注册、工具调用以及与客户端的 JSON-RPC 通信。包含针对 Slack、Jira 等的 MCP 服务实现样例,以及一个较完整的 MCP 服务框架和核心工具注册/执行逻辑。
-
主要功能点
- MCP 服务器核心:支持通过 MCP 的工具注册、查询、执行等能力,提供“注册工具、调用工具、获取资源/提示模板”等后端能力。
- 多域服务结构:包括 HR、市场、Tech、数据、流程等领域的工具集合,以及一个专门的工厂/注册机制来集中管理工具。
- 与客户端通信:通过 MCP 标准的工具注册与调用接口,满足客户端对资源访问、工具执行与 Prompts 的请求与响应。
- 服务器实现与示例:包含基于 FastMCP 的实现,及若干 MCP 服务的实现样例,提供了从注册工具到执行工具的完整流程。
- 运行与运维:包含启动脚本/示例、服务注册、以及简单的健康/状态接口,便于本地开发与测试。
-
安装步骤
- 请在具备 Python 环境的机器上,安装依赖并确保可执行的 Python 运行环境。
- 进入项目根目录,按照仓库中提供的脚本/入口执行 MCP 服务器:
- 运行一个示例服务器(标准模式,stdio/HTTP 等传输,根据实际需求选择)来启动 MCP 服务。
- 如果你使用的是示例架构(如 archive 下的 MCP 服务器实现),请确保 Python 环境配置、依赖安装完成后执行对应的启动脚本。
-
服务器配置(MCP 客户端需要的配置信息;JSON 格式,包含 server name、command、args 等)
- 下面是一个符合仓库信息、可直接用于 MCP 客户端连接的示例配置(JSON 结构,非代码块呈现,便于阅读): { "server_name": "sm-assistant-mcp-server", "command": ["python", "archive/mcp_infrastructure/mcp_server/mcp_server.py"], "args": [ "--transport", "stdio", "--host", "0.0.0.0", "--port", "9000" ], "description": "SM-Assistant MCP 服务器实例(多域工具、资源与提示模板托管,MCP 客户端通过命令行/管道与之通信)" }
-
基本使用方法
- 启动服务器:按照上述配置在本地或服务器上启动 MCP 服务进程。
- 连接与交互:MCP 客户端通过 JSON-RPC 调用注册的工具、读取资源、执行工具等。服务器将返回标准的 MCP JSON-RPC 响应,或通过通知接口推送信息。
- 监控与调试:检查启动日志、工具注册信息、以及健康状态输出,确保工具在期望域中可用。