Magi Core

MCPAI代理

提供方 moogsG

AI代理 stdio · 本地进程 无需鉴权 社区 / 第三方
查看接入方式

一个快速、私密、轻量级的本地任务管理系统,通过MCP协议与Slack和Microsoft 365等工具集成。

一句话选型结论

按资料字段整理

Magi Core 属于AI代理类 MCP 服务器,stdio · 本地进程,无需鉴权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

任务管理TypeScript本地部署本地优先Slack集成Microsoft365集成MCP协议

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
docker run -d \

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Magi Core当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方moogsG上游标注的维护方 moogsG
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.7 KB
来自项目仓库与上游目录的原文,未做删改

MCP本地任务

> 本地第一台MCP服务器,用于管理Slack和Microsoft 365的开发任务

一个快速、私有、令牌精简的任务管理系统,在本地运行,并通过模型上下文协议(MCP)与现有工具集成。

✨ 特性

  • 🔒 本地优先和私人 -所有数据都存储在SQLite本地
  • 🚀 快速 -带FTS5全文搜索的Sub-100ms缓存列表
  • 🔌 可扩展 -适用于Slack、Microsoft 365等的可插拔连接助手
  • 💡 代币精益 -返回紧凑型手柄;按需扩展
  • 🛠️ MCP协议 -AI助手的标准stdio传输

🚀 快速开始```bash

Install dependencies

bun install

Copy sample environment file and configure

cp sample.env .env

Edit .env with your settings (Slack tokens, channels, etc.)

Build all packages

bun run build

Run tests

bun test

Start MCP server

bun run dev


### 混合搜索设置```bash
# 1. Seed test data with invoice mismatch scenarios
cd packages/server
bun run seed:hybrid

# 2. Run benchmark (should complete in <120ms)
bun run test:hybrid

# 3. (Optional) Start Qdrant for semantic search
docker run -d \
-p 6333:6333 \
-v $(pwd)/data/qdrant_storage:/qdrant/storage \
--name qdrant \
qdrant/qdrant

# 4. (Optional) Initialize Qdrant collection
cd packages/data
bun run init-qdrant

🔧 MCP工具

服务器通过MCP协议公开这些工具:

任务管理

  • task.create -创建一个包含标题、正文、优先级和截止日期的新任务
  • task.list -将任务列为具有过滤和搜索功能的紧凑句柄
  • task.expand -按ID获取完整的任务详细信息
  • task.update -更新任务字段(状态、优先级等)
  • task.queryHybrid -结合关键字(FTS5)+语义(Qdrant)搜索和加权排名的混合搜索

Slack集成(通过连接器)

  • slack.list_channels -列出可用的Slack频道
  • slack.get_history -从频道获取消息历史记录
  • slack.post_message -将消息发布到频道
  • slack.summarize_messages -使用日期/频道过滤器获取格式化为AI摘要的消息

📦 项目结构```

packages/
server/ # Main MCP server with SQLite storage
data/ # Analytics & vector search layer
src/
snapshot.ts # SQLite → Parquet export
duckdb-views.ts # Analytical views (today, week, overdue)
qdrant-init.ts # Vector collection setup
embedder.ts # Batch embedding (stub + OpenAI)
hybrid-search.ts # Weighted ranking merge
connectors/
slack/ # Slack integration
ms/ # Microsoft 365 integration
template/ # Echo helper example
docs/
PROJECT_PLAN.md # Full project specification
helpers.md # Guide for writing connection helpers
HYBRID_SEARCH_GUIDE.md # Hybrid search setup and usage
config.json # Helper configuration


## 🧩 可扩展性

### 配置系统

MAGI Core使用双文件配置系统:

1. **`config.json`** -定义要加载的助手及其模块路径
1. **`.env`** -包含所有配置值(机密、通道、设置)

环境变量 **始终覆盖** 值在 `config.json`,使其易于:

- 将秘密置于版本控制之外
- 根据环境使用不同的设置
- 共享基础配置,同时根据部署进行自定义

### 添加连接器

编辑 `config.json` 定义要加载哪些助手:```json
{
"helpers": [
{
"name": "slack",
"module": "./packages/connectors/slack/dist/index.js",
"config": {}
}
]
}

然后在中配置助手 .env:```bash

Slack Configuration

SLACK_APP_TOKEN=xapp-...
SLACK_BOT_TOKEN=xoxb-...
SLACK_ALLOWED_CHANNELS=#dev,#ai,#support
SLACK_USER_ID=U123456789
SLACK_SWEEPER_MINUTES=10
SLACK_ENABLE_TODO_DETECTION=true
SLACK_ENABLE_BACKGROUND_SERVICES=true


**两种模式:**

- **MCP模式** (`SLACK_ENABLE_BACKGROUND_SERVICES=false`):仅限工具,无后台服务
- **守护程序模式** (`SLACK_ENABLE_BACKGROUND_SERVICES=true`):全插座模式、清扫器等。

看 `docs/helpers.md` 获取助手编写指南和 `docs/config.md` 以获取完整的配置参考。

## 🧪 测试```bash
# Run all tests
bun test

# Run server tests only
cd packages/server
bun test

# Run hybrid search benchmark
bun run test:hybrid

当前测试覆盖率:

  • ✅ 任务创建和列表
  • ✅ 任务扩展
  • ✅ 任务更新
  • ✅ FTS关键字搜索
  • ✅ 混合搜索(平均0.73ms,比120ms目标快164倍)

📚 文档

  • 项目计划 -完整的规格和架构
  • 混合搜索指南 -设置和使用指南
  • 助手指南 -如何编写连接助手
  • 实施总结 -建造了什么
  • 数据包 -分析和矢量搜索
  • 服务器包 -服务器详细信息
  • 连接器模板 -示例助手

🎯 路线图

  • [x] 混合搜索 -FTS5+Qdrant加权排名(平均0.73ms)
  • [x] DuckDB分析 -拼花地板快照和分析视图
  • [x] Qdrant矢量搜索 -基础设施就绪,存根嵌入器已实现
  • [x] Markdown导出 -导出任务并提供及时建议
  • [x] 松弛连接器 -Socket模式集成
  • [x] Microsoft 365连接器 -Outlook+日历集成
  • []真正的OpenAI嵌入(目前使用存根)
  • []CLI/TUI用于本地使用
  • []高级过滤和日期范围
  • []查询缓存和优化

🛠️ 发展

内置:

  • TypeScript -类型安全开发
  • 包子 -快速JavaScript运行时和包管理器
  • SQLite -配备FTS5的高性能本地数据库
  • DuckDB -分析和拼花地板出口
  • Qdrant -语义相似度的向量搜索
  • MCP-SDK -模型上下文协议
  • Vitest -快速单元测试

⚡ 演出

  • 混合搜索:平均0.73ms(比120ms目标快164倍)
  • 任务列表:带FTS5索引的Sub-100ms
  • 关键字搜索:15个任务约0.2毫秒
  • 已准备好扩大规模:通过发票不匹配场景进行了测试

📄 许可证

麻省理工学院

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Magi Core 怎么安装?

在客户端按下面的安装命令接入:docker run -d \。装完在客户端配置里引用同一个包或端点。

Magi Core 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Magi Core 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Magi Core 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Magi Core 能提供哪些能力?

资料显示能力标签包括 本地优先、TypeScript、Slack、任务管理。具体工具清单以官方文档为准。

Magi Core 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

Magi Core 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。