内容
# Qiita MCP 服务器
一个用于与知识分享平台 Qiita 交互的模型上下文协议(MCP)服务器。
[](https://opensource.org/licenses/MIT)
## 概述
本软件包提供一个模型上下文协议(MCP)服务器,使 AI 代理能够与 Qiita API 交互。通过标准化的 MCP 工具,可以在 Qiita 上创建、读取和更新文章。
MCP 是一个开放协议,用于构建可以利用外部工具和服务的 AI 代理。该服务器实现了 MCP 规范,为处理 Qiita 内容提供了工具。
## 提供工具
服务器提供以下 MCP 工具:
| 工具名称 | 描述 |
|-----------|-------------|
| 获取我的 Qiita 文章 | 获取当前认证用户的 Qiita 文章 |
| 获取 Qiita 文章 | 通过 ID 获取特定的 Qiita 文章 |
| 发布 Qiita 文章 | 在 Qiita 上创建新文章 |
| 更新 Qiita 文章 | 更新现有的 Qiita 文章 |
| 获取 Qiita Markdown 规则 | 获取 Qiita Markdown 语法规则和速查表 |
## 使用方法
### 前置条件
- Node.js (>=20.0.0)
- 具有 API 访问令牌的 Qiita 账户
- 您可以通过访问:https://qiita.com/settings/tokens/new 生成 Qiita API 令牌
### 在 VS Code 中使用
1. 在您的项目中创建一个 `.vscode/mcp.json` 文件,内容如下:
```json
{
"inputs": [
{
"type": "promptString",
"id": "qiita-api-token",
"description": "Qiita API 令牌",
"password": true
}
],
"servers": {
"qiita-mcp-server": {
"type": "stdio",
"command": "npx",
"args": ["@2bo/qiita-mcp-server"],
"env": {
"QIITA_API_TOKEN": "${input:qiita-api-token}"
}
}
}
}
```
## 开发
### 设置
1. 克隆仓库:
```bash
git clone https://github.com/2bo/qiita-mcp-server.git
cd qiita-mcp-server
```
2. 安装依赖:
```bash
npm install
```
3. 配置环境:
- `npm run dev` - 以监听模式运行 TypeScript 进行开发
- `npm run build` - 构建项目
- `npm run prepare` - 准备发布软件包
### 贡献
欢迎贡献!请随时提交拉取请求。
## 许可证
该项目根据 MIT 许可证授权 - 有关详细信息,请参阅 LICENSE 文件。