内容
# 代理技能MCP服务器
本仓库通过模型上下文协议（MCP）服务器公开了一系列代理技能（系统提示、指南和工作流程，以Markdown格式）。通过将这些文件作为资源和工具托管，任何与MCP兼容的编码代理（例如Claude Desktop或Cursor）都可以发现并使用这些技能来执行专门的开发者任务。
## 📁 仓库结构
* `resources/`：按类别组织的Markdown文件（`SKILL.md`）。
* `resources/langgraph/`：LangGraph初始化、工作流程和可观察性。
* `resources/solidity/`：Foundry、EVM部署和生命周期。
* `resources/docker/`：Ollama、ChromaDB和容器生命周期。
* `resources/frontend/`：Next.js初始化、GLB到JSX转换和PR准备。
* `src/agent_skills_server/`：FastMCP服务器应用程序代码。
* `tests/`：单元测试套件。
* `.gemini/AGENTS.md`：AI代理贡献的技术风格指南和规则。
## 🚀 快速入门
### 前提条件
确保已安装 [uv](https://github.com/astral-sh/uv)：
```bash
curl -LsSf https://astral-sh/uv/install.sh | sh
```
### 安装
克隆仓库并安装所有依赖项：
```bash
git clone https://github.com/dor-rondel/agent-skills.git
cd agent-skills
make install
```
### 在本地运行服务器
#### 开发和测试模式（MCP检查器）
FastMCP包含一个基于浏览器的检查器，用于测试工具和资源。要运行它：
```bash
uv run fastmcp dev src/agent_skills_server/server.py
```
此命令启动服务器并在浏览器中打开MCP检查器（通常在 `http://localhost:5173`）。
#### 以生产模式运行（stdio）
要运行服务器以便MCP客户端通过标准I/O进行通信：
```bash
uv run fastmcp run src/agent_skills_server/server.py
```
## 🔌 连接到MCP客户端
您可以使用以下任一方式将LLM代理连接到服务器：
* **选项A：自动子进程（Stdio）**：客户端在需要时将服务器作为后台子进程启动。（推荐，无需手动保持服务器终端运行）。
* **选项B：持久服务器（SSE/HTTP）**：您手动在端口上运行服务器（`http://127.0.0.1:8000/sse`），客户端通过HTTP连接到它。
* 要持久运行：
```bash
uv run fastmcp run --transport sse --port 8000 src/agent_skills_server/server.py
```
### Claude Desktop
将服务器定义添加到Claude Desktop配置文件中：
* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Linux**: `~/.config/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
#### 选项A：自动子进程（Stdio）
```json
{
"mcpServers": {
"agent-skills": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/agent-skills",
"run",
"fastmcp",
"run",
"src/agent_skills_server/server.py"
]
}
}
}
```
#### 选项B：持久服务器（SSE）
```json
{
"mcpServers": {
"agent-skills": {
"url": "http://127.0.0.1:8000/sse"
}
}
}
```
### Cursor
前往 **设置** > **功能** > **MCP** 并点击 **+ 添加新MCP服务器**。
#### 选项A：自动子进程（Stdio）
* **名称**: `agent-skills`
* **类型**: `command`
* **命令**: `uv --directory /absolute/path/to/agent-skills run fastmcp run src/agent_skills_server/server.py`
#### 选项B：持久服务器（SSE）
* **名称**: `agent-skills`
* **类型**: `SSE`
* **网址**: `http://127.0.0.1:8000/sse`
### VS Code / Google Antigravity
1. 打开IDE设置（左下角的齿轮图标）。
2. 进入 **自定义** 选项卡。
3. 点击 **打开MCP配置** 以打开 `mcp_config.json`。
#### 选项A：自动子进程（Stdio）
在 `mcpServers` 键下添加配置：
```json
{
"mcpServers": {
"agent-skills": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/agent-skills",
"run",
"fastmcp",
"run",
"src/agent_skills_server/server.py"
]
}
}
}
```
#### 选项B：持久服务器（SSE）
在 `mcpServers` 键下添加配置：
```json
{
"mcpServers": {
"agent-skills": {
"serverUrl": "http://127.0.0.1:8000/sse"
}
}
}
```
## 🛠️ 开发和质量控制
本仓库在合并代码前强制执行严格的代码质量检查。您可以在本地运行所有验证工具：
* **格式化代码**: `make format`
* **代码检查**: `make lint`
* **运行单元测试**: `make test`
* **拼写检查**: `make spell`
* **运行所有检查（等同于CI）**: `make check`
