关键词

Slackmemory managementAI agentsautomationClaude SDK

项目简介

KIRA MCP Server Suite 是一个基于 Claude SDK 的本地化 MCP 服务器集合，旨在通过标准化的 MCP 框架向 LLM 客户端提供资源、工具、提示模板等上下文服务。它把资源管理、工具注册执行、以及 Prompt 模板的渲染等能力组织成可扩展的 MCP 服务集合，方便在本地环境中构建强大的 LLM 驱动应用。

主要功能点

  • MCP 服务集合：大量以 create_<name>_mcp_server 方式实现的 MCP 服务，例如 slack、scheduler、deepl、perplexity、atlassian 等，支持工具调用、资源访问、提示渲染等能力。
  • 资源与记忆管理：提供本地资源、内存、任务、会议记录等数据结构，以及相关数据库（如 email_tasks、jira_tasks、waiting_answer 等）的存储与查询能力。
  • 工具与服务注册：不同的子模块暴露多种工具，供 MCP 客户端在对话中调用，例如 slack_tools、email_tasks_mcp、jira_tasks_mcp、deepl_tools、x、ms365、atlassian 等。
  • Prompt 与状态管理：通过 state_prompt 与 system_prompt 组合，控制 MCP 客户端对话中的上下文、约束与工作流，确保多阶段任务的可控性。
  • 本地化运行与开发支持：提供 dev.py 热重载开发服务器、Electron 桌面应用和文档站点等完整开发/调试环境。
  • 多源集成能力：内置 Perplexity、DeepL、GitHub、GitLab、Microsoft 365、Atlassian、X、Clova、Playwright 等多源 MCP 服务，支持本地私有云或内部基础设施的扩展。

安装与运行步骤

  • 环境准备
    • 确保已安装 Python 3.10+、Node.js（用于 Electron/UI 相关），并具备网络访问能力以拉取需要的 MCP 工具包。
  • 代码获取与依赖
    • 克隆仓库并进入项目根目录，安装依赖（如 requirements.txt 与前端依赖）：
      • Python 依赖安装示例：pip install -r requirements.txt
      • Electron/Vite 相关依赖示例：在 electron-app 与 vitepress-app 目录分别执行 npm install
  • 启动开发服务器
    • 启动后端 MCP 与核心应用（开发热重载模式）：
      • 启动 Python 开发服务器（示例命令，实际脚本在 dev.py 中实现热reload 调度）： python3 dev.py
    • 启动 Electron 桌面应用（如需本地调试 UI/配置）：
      • 进入 electron-app，执行 npm install && npm start
  • MCP 客户端配置
    • MCP 客户端需要知道要连接的 MCP 服务器启动命令和参数（JSON 配置），下方给出示例配置，实际连接时请按组织内部的部署方式进行调整。
    • 服务器配置示例（JSON，供 MCP 客户端使用）： [ { "name": "slack", "command": "python3", "args": ["-m", "app.cc_tools.slack.slack_tools"] }, { "name": "scheduler", "command": "python3", "args": ["-m", "app.cc_tools.scheduler.scheduler_tools"] }, { "name": "files", "command": "python3", "args": ["-m", "app.cc_tools.files.files_tools"] }, { "name": "perplexity", "command": "npx", "args": ["-y", "server-perplexity-ask"], "env": { "PERPLEXITY_API_KEY": "<YOUR_PERPLEXITY_API_KEY>" } }, { "name": "ms365", "command": "npx", "args": ["mcp-cache", "npx", "-y", "@batteryho/lokka-cached"], "env": { "TENANT_ID": "<YOUR_TENANT_ID>", "CLIENT_ID": "<YOUR_CLIENT_ID>", "USE_INTERACTIVE": "true" } } ]
  • 说明：
    • 上述配置仅为示例，实际部署时请按照仓库中各 MCP 服务器的实现方式提供对应的启动命令、参数，以及必要的环境变量。
    • MCP 客户端在连接时需要提供 server name、command、args 等信息，以上示例展示了名称与对应的启动方式。若某些服务器以远端 HTTP 形式暴露，请使用 type: "http" 的形式在客户端配置中指定 URL 与认证信息。

服务器使用方法

  • 通过 Claude/LLM 客户端向 MCP 服务器发起请求以完成读取资源、执行工具、获取 Prompt 等操作。
  • MCP 服务通过 Claude SDK 提供的工具、系统提示和状态信息，支持多阶段任务（如内存管理、任务调度、Proactive/Dynamic 提案等）。
  • 通过本仓库提供的工具集合，可以实现对 Slack、Outlook、Confluence/Jira、GitHub/GitLab、X 等多源系统的集成操作。

关键点与注意事项

  • 该仓库实现的是一组 MCP 服务的服务端能力（以 Claude SDK 的 MCP 服务器形式实现），并通过多种工具和数据存储实现对上下文的管理和对外部系统的调用。
  • 在实际生产环境中，应将敏感信息（如 API Key、Token、Secret）通过安全的配置与密钥管理进行管理，避免直接硬编码在配置中。
  • MCP 服务的运行需要相应的 Claude SDK 环境与依赖，确保客户端可以通过规定的启动命令与参数正确连接到各 MCP 服务。

关键词

Slack, 内部内存管理, 自动化, AI 代理, 开发者工具

分类/领域

6

信息

分类

AI与计算

访问项目