Token导航 LogoToken导航TokenDH.com
Devwisdom Go logo
开发工具未说明官方级别未说明来源级核验

Devwisdom Go

MCP Server

一个独立的Go MCP服务器,为开发者提供智慧名言、可信建议和灵感指导,适用于日常开发激励和项目健康监控。

工具数

0

提示词数

0

GitHub Stars

0

资源数

0
开发工具Go命令行工具

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

davidl71

提供方

davidl71

最后核验

2026/5/17 20:23

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

详细介绍

天神走

智慧模块提取(概念验证)

一个独立的Go MCP服务器,为开发人员提供智慧引语、值得信赖的顾问和鼓舞人心的指导。从exarp项目中提取,作为对exarp模块使用编译语言(Go)的概念证明。

![CI](https://github.com/davidl71/devwisdom-go/actions/workflows/ci.yml) ](https://golang.org/) ![License](LICENSE)

🎯 项目状态

第一阶段: ✅ 完整(核心结构)\ 第2阶段: ✅ 完成(智慧数据移植-16/21本地来源)\ 第三期: ✅ 完整(顾问系统)\ 阶段4: ✅ 完成(MCP协议实施)\ 第4.5阶段: ✅ 完成(SDK迁移-2026-01-09)\ 第6阶段: ✅ 完成(随机源选择器)\ 电流相位:第5阶段(咨询记录)\ 语言:转到1.23+\ MCP-SDK:官方 modelcontextprotocol/go-sdk v1.2.0\ 类型:MCP服务器/开发人员工具

📋 快速开始

# Clone the repository
git clone 
cd devwisdom-go

# Build MCP server
make build

# Build CLI
make build-cli

# Run MCP server
make run

# Run CLI commands
./devwisdom-cli quote
./devwisdom-cli consult --metric security --score 75
./devwisdom-cli briefing --days 7

# Run with watchdog (crash monitoring + file watching)
make watchdog

# Test
make test

💻 CLI使用情况

devwisdom CLI提供了对智慧名言和顾问咨询的便捷访问。CLI可以在两种模式下运行:

  • 命令行接口命令模式:从终端运行时(stdin是TTY)
  • MCP服务器模式:通过stdio运行时(用于MCP集成)

构建CLI

# Build CLI binary
make build-cli

# Build both server and CLI
make build-all

# Install CLI globally
make install-cli

命令

# Get a random wisdom quote (date-seeded, consistent per day)
devwisdom quote

# Get quote from specific source
devwisdom quote --source stoic

# Get quote with score context (affects aeon level selection)
devwisdom quote --source art_of_war --score 85

# Get quote in JSON format
devwisdom quote --json

# Get quote text only (quiet mode)
devwisdom quote --quiet

# Consult an advisor for a metric
devwisdom consult --metric security --score 40

# Consult an advisor for a tool
devwisdom consult --tool project_scorecard --score 75

# Consult an advisor for a workflow stage
devwisdom consult --stage daily_checkin --score 60

# List all available wisdom sources
devwisdom sources

# List sources in JSON format
devwisdom sources --json

# List all available advisors
devwisdom advisors

# List advisors in JSON format
devwisdom advisors --json

# Get daily briefing (today's wisdom)
devwisdom briefing

# Get briefing for last 7 days
devwisdom briefing --days 7

# Get briefing in JSON format
devwisdom briefing --json

# Show version
devwisdom version

# Show help
devwisdom help

例子

# Quick daily wisdom
devwisdom quote

# Security advice when score is low
devwisdom consult --metric security --score 25

# Planning stage advice
devwisdom consult --stage planning --score 60

# View all Stoic quotes available
devwisdom sources --json | jq '.[] | select(.name == "stoic")'

# Get quote for high-performing project
devwisdom quote --source pistis_sophia --score 90

# Get quiet quote for scripts
QUOTE=$(devwisdom quote --quiet)
echo "Today: $QUOTE"

命令选项

quote 命令:

  • --source SOURCE:智慧源名称(例如。, stoic, pistis_sophia, random)
  • --score SCORE:项目健康评分(0-100),影响aeon级别选择
  • --json:JSON格式的输出
  • --quiet:仅输出报价文本

consult 命令:

  • --metric METRIC:度量名称(例如。, security, testing, documentation)
  • --tool TOOL:工具名称(例如。, project_scorecard)
  • --stage STAGE:舞台名称(例如。, daily_checkin, sprint_planning)
  • --score SCORE:项目健康评分(0-100),用于度量/工具咨询
  • --json:JSON格式的输出
  • --quiet:仅输出报价文本

briefing 命令:

  • --days DAYS:要包含的天数(默认值:1)
  • --json:JSON格式的输出

用例

每日站立:

# Get today's wisdom for team standup
devwisdom quote

项目健康监测:

# Get advice based on current project score
SCORE=$(calculate-project-score)
devwisdom consult --metric security --score $SCORE

CI/CD集成:

# Add wisdom to build notifications
QUOTE=$(devwisdom quote --quiet)
echo "Build wisdom: $QUOTE" | send-notification

文档生成:

# Generate markdown with quotes
devwisdom sources --json | jq -r '.[] | "## \(.name)\n\n\(.description)\n"'

📚 有关详细的使用示例,请参阅:

快速参考

命令描述示例
quote获取智慧名言devwisdom quote --source stoic
consult咨询顾问devwisdom consult --metric security --score 40
sources列出来源devwisdom sources
advisors列出顾问devwisdom advisors
briefing每日简报devwisdom briefing --days 7
version显示版本devwisdom version
help显示帮助devwisdom help

🐚 Zsh插件

安装zsh插件,以便与标签完成和帮助函数方便地进行shell集成。

安装

自动安装(推荐)

# From project root
cd zsh
./install.sh

安装脚本将:

  • 检测你的zsh框架(哦,我的zsh或标准zsh)
  • 将插件文件复制到适当的位置
  • 配置您的 ~/.zshrc 自动地
  • 设置选项卡完成

手动安装

对于我的zsh用户:

# Create plugin directory
mkdir -p ~/.oh-my-zsh/custom/plugins/devwisdom

# Copy plugin files
cp zsh/devwisdom.plugin.zsh ~/.oh-my-zsh/custom/plugins/devwisdom/
cp zsh/_devwisdom ~/.oh-my-zsh/custom/plugins/devwisdom/

# Make completion executable
chmod +x ~/.oh-my-zsh/custom/plugins/devwisdom/_devwisdom

# Add to ~/.zshrc
echo 'plugins=(... devwisdom)' >> ~/.zshrc

对于标准zsh用户:

# Create plugin directory
mkdir -p ~/.zsh/plugins/devwisdom

# Copy plugin files
cp zsh/devwisdom.plugin.zsh ~/.zsh/plugins/devwisdom/
cp zsh/_devwisdom ~/.zsh/plugins/devwisdom/

# Make completion executable
chmod +x ~/.zsh/plugins/devwisdom/_devwisdom

# Add to ~/.zshrc
cat >> ~/.zshrc               # Shows: quote, consult, sources, advisors, briefing

# Tab completion for options
devwisdom quote --       # Shows: --source, --score, --json, --quiet
devwisdom consult --    # Shows: --metric, --tool, --stage, --score, --json, --quiet

汽车日常智慧

在shell启动时启用自动日常智慧:

# Add to ~/.zshrc
export DEVWISDOM_AUTO_DAILY=true

启用后,每次打开新的终端会话时,您都会看到每日智慧语录。

用例

日常动机:

# Add to ~/.zshrc for daily inspiration
devwisdom-daily

项目健康检查:

# Quick consultation when starting work
devwisdom-consult security $(get-project-score)

脚本集成:

#!/bin/zsh
# Get wisdom for automation scripts
QUOTE=$(devwisdom quote --json)
echo "Today's wisdom: $(echo $QUOTE | jq -r '.quote')"

自定义别名:

# Add to ~/.zshrc
alias wisdom='devwisdom quote'
alias advice='devwisdom consult'
alias daily='devwisdom-daily'

🔄 看门狗脚本

该项目包括一个监视脚本,用于监视服务器是否崩溃,并可以在文件更改时自动重新加载。

基本用法

# Monitor for crashes only
./watchdog.sh

# Watch files and reload on changes
./watchdog.sh --watch-files

# Watch files and restart on changes
./watchdog.sh --watch-files --restart-on-change

# Log to file
./watchdog.sh --watch-files --log-file watchdog.log

特性

  • 碰撞检测:如果服务器崩溃,则自动重新启动服务器
  • 文件监视:监视器 sources.json、配置文件和Go源文件
  • 热重新加载:在不完全重新启动的情况下重新加载源(如果支持)
  • 自动重建:Go源文件更改时重建二进制文件
  • 重启限制:可配置的最大重启尝试次数
  • 优雅关闭:处理SIGTERM以实现干净停机

监视器选项

  • --watch-files:启用文件监视(使用 fswatch 在macOS上,退回到轮询)
  • --restart-on-change:文件更改时重新启动服务器(默认值:reload)
  • --log-file PATH:将输出记录到文件
  • --pid-file PATH:自定义PID文件位置
  • --max-restarts N:最大重启尝试次数(默认值:10)
  • --restart-delay SEC:重新启动之间的延迟(默认值:2)

生成文件目标

make watchdog          # Run with file watching and reload
make watchdog-restart  # Run with file watching and restart on change
make watchdog-monitor  # Run with crash monitoring only

交叉编译

为多个平台构建二进制文件:

# Build for specific platform
make build-windows     # Windows (amd64)
make build-linux       # Linux (amd64, arm64)
make build-darwin      # macOS (amd64, arm64)

# Build for all platforms
make build-all-platforms

# Build and package release archives
make build-release     # Creates zip/tar.gz archives in dist/release/

发布档案:

  • 窗户: devwisdom-{version}-windows-amd64.zip
  • Linux: devwisdom-{version}-linux-{arch}.tar.gz
  • macOS: devwisdom-{version}-darwin-{arch}.tar.gz

构建工件:

  • 二进制文件放置在 dist/{platform}-{arch}/
  • 发布档案放在 dist/release/
  • 使用 make clean-dist 删除所有构建工件

🔄 CI/CD

持续集成

该项目使用GitHub Actions for CI/CD:

  • CI工作流 (.github/workflows/ci.yml):

- 根据推送和拉取请求运行 - Go 1.21和1.22测试 - 用golangci棉绒织物 - 生成二进制文件以验证编译 - 上传测试覆盖率报告

  • 发布工作流 (.github/workflows/release.yml):

- 版本标签上的触发器(例如。, v1.0.0) - 为所有平台构建二进制文件: - Windows(amd64) - Linux(amd64、arm64) - macOS(amd64、arm64) - 创建包含所有工件的GitHub版本 - 自动生成发行说明

创建发布

# Create and push a version tag
git tag -a v1.0.0 -m "Release v1.0.0"
git push origin v1.0.0

发布工作流将自动:

  1. 为所有平台构建二进制文件
  2. 将它们打包到发布档案中
  3. 创建GitHub版本
  4. 将所有工件附加到发布中

CI/CD状态

查看工作流状态和日志:

🏗️ 项目结构

devwisdom-go/
├── cmd/server/          # MCP server entry point
├── internal/
│   ├── wisdom/         # Wisdom engine (quotes, sources, advisors)
│   ├── mcp/            # MCP protocol handler
│   └── config/         # Configuration management
├── docs/               # Documentation
├── Makefile           # Build commands
└── go.mod             # Go dependencies

📊 规划和状态

任务在中跟踪 举个例子 (Todo2 SQLite)。看 PROJECT_GOALS.md 用于相位分解和 PRD.md 以满足全部要求。

🚀 阶段

  1. 第一阶段:核心结构(完整)
  2. 第2阶段:智慧数据移植(16/21本地来源完整)
  3. 第三期:顾问系统
  4. 阶段4:MCP协议实施
  5. 阶段5:咨询记录
  6. 第6阶段:每日随机源选择(完整)
  7. 第7阶段:可选功能(Sefaria API)
  8. 第8阶段:测试
  9. 第9阶段:文件
  10. 第10阶段:波兰和部署

📚 文档

核心文件

  • 项目_高斯.md -战略阶段和目标
  • PRD.md -产品需求文档(129个用户故事)
  • TODO.md -按阶段划分的任务

参考文件

  • docs/README.md -完整的文档索引
  • docs/WATCHDOG.md -看门狗脚本文档
  • docs/PERFORMANCE.md -性能分析和基准测试
  • docs/MCP_SERVERS.md -MCP服务器配置指南
  • docs/CURSOR_EXTENSION.md -游标扩展架构(⚠️ 未来目标-目前尚未实现)

docs/README.md 获取完整的文档索引。

🔗 相关

  • :Python智慧模块 exarp 项目
  • MCP规范: https://modelcontextprotocol.io/
  • Go文档: https://go.dev/doc/effective_go

📝 许可证

\[在此处添加您的许可证\]

👤 作者

从exarp项目中提取,作为编译语言PoC。

目录标签

目录标签

开发工具Go命令行工具开发者工具本地部署名言服务项目咨询Go语言

接入字段

传输方式(transport,传输协议)

未说明

鉴权方式(authType,认证方式)

none

工具数量(toolCount,工具数)

0

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

未说明none部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

仍需确认:installCommand

来源信息

继续浏览同类 MCP