Alayman MCP服务器
一个模型上下文协议（MCP）服务器，提供对以下内容的访问 阿拉曼尼奥 通过STDIO传输与Claude Code和其他MCP客户端一起使用。
特性
- 工具：
fetch-articles-从带有可选筛选的alayman.io API获取文章 - STDIO传输 -与Claude Code和其他基于STDIO的MCP客户端兼容
- 类型安全 -使用TypeScript和Zod验证构建
安装
npm install建筑
npm run build添加到克劳德代码
按照以下步骤将Alayman MCP服务器添加到Claude Code中：
第一步：构建项目
首先，克隆存储库并构建项目：
git clone
cd alayman-mcp-ts
npm install
npm run build步骤2：找到您的Claude代码配置文件
配置文件的位置取决于您的操作系统：
- macOS/Linux:
~/.config/claude/config.json - 视窗:
%APPDATA%\claude\config.json
如果文件不存在，请使用空JSON对象创建它： {}
步骤3：添加MCP服务器配置
编辑配置文件并添加 mcpServers 部分。 重要：使用项目生成目录的绝对路径。
{
"mcpServers": {
"alayman": {
"command": "node",
"args": [
"/absolute/path/to/alayman-mcp-ts/build/index.js"
]
}
}
}macOS/Linux示例：
{
"mcpServers": {
"alayman": {
"command": "node",
"args": [
"/Users/yourname/Projects/alayman-mcp-ts/build/index.js"
]
}
}
}Windows示例：
{
"mcpServers": {
"alayman": {
"command": "node",
"args": [
"C:\\Users\\yourname\\Projects\\alayman-mcp-ts\\build\\index.js"
]
}
}
}步骤4：重新启动Claude代码
完全重新启动Claude Code（退出并重新打开）以使更改生效。
步骤5：验证安装
您可以通过询问Claude来验证MCP服务器是否正常工作：
- “列出所有alayman的文章”
- “获取有关React的文章”
- “显示alayman的最新5篇文章”
用法
配置完MCP服务器后，您可以通过Claude Code自然地与之交互。服务器提供 fetch-articles Claude可以根据您的请求自动使用的工具。
查询示例
获取所有文章：
List all articles from alayman.io搜索特定主题：
Find all Angular articles from alayman限制结果：
Show me the 10 most recent articles分页：
Get articles 20-40 from alayman运作原理
当您提出与alayman.io文章相关的请求时，Claude Code将自动：
- 认识到它应该使用
fetch-articles工具 - 使用适当的参数调用MCP服务器
- 格式化并向您展示结果
您不需要手动调用该工具，只需自然地提问即可！
可用工具
获取文章
从alayman.io API获取具有可选筛选和分页功能的文章。
参数：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
limit | number | 否 | 要返回的最大文章数（默认值：20） |
offset | number | 否 | 分页时要跳过的文章数（默认值：0） |
search | string | 否 | 按标题、副标题或内容筛选文章的搜索词 |
使用示例：
- 获取所有文章（默认）：
{}- 搜索特定主题：
{
"search": "Angular"
}- 限制结果：
{
"limit": 10
}- 分页（获取文章20-40）：
{
"limit": 20,
"offset": 20
}- 带限制的组合搜索：
{
"search": "React",
"limit": 5
}响应格式：
{
"articles": [
{
"id": 307,
"title": "Article Title",
"subtitle": "Article subtitle...",
"image": "https://...",
"url": "https://medium.com/...",
"name": "Author Name",
"time": "2025-08-23T06:07:28Z",
"readtime": "5 min read",
"category": 1,
"description": "",
"shareCount": 0,
"checkCount": 3
}
],
"total": 30,
"offset": 0,
"limit": 20,
"has_more": true
}响应字段：
articles：文章对象数组total：与查询匹配的文章总数offset：当前分页偏移量limit：返回的最大文章数has_more：布尔值，表示是否有更多文章可用
项目结构
alayman-mcp-ts/
├── src/
│ └── index.ts # Main server implementation
├── build/ # Compiled JavaScript (generated)
├── package.json # Project dependencies and scripts
├── tsconfig.json # TypeScript configuration
├── .gitignore # Git ignore rules
└── README.md # This file发展
观看模式
npm run watch这将在TypeScript文件更改时自动重新编译它们。
日志记录
所有服务器日志都将写入 stderr （不是 stdout)以避免损坏MCP协议消息。查找前缀为的日志 [MCP].
API文档
服务器从以下位置获取数据： https://alayman.io/api/articles
支持的查询参数：
limit-最大结果offset-分页偏移search-搜索筛选器
许可证
麻省理工学院
贡献
欢迎投稿！请随时提交拉取请求。
故障排除
服务器未出现在Claude代码中
- 验证您的路径
config.json是绝对的，不是相对的 - 确保你跑了
npm run build更改后 - 配置更改后完全重新启动Claude Code
- 检查Claude Code日志中的MCP服务器错误
API错误
- 核实一下
https://alayman.io/api/articles可访问的 - 检查您的互联网连接
- 查看stderr中的服务器日志以了解详细的错误消息
快速参考
常见自然语言查询
安装后，您可以将这些自然语言查询与Claude Code一起使用：
| 您想要什么 | 示例查询 |
|---|---|
| 所有文章 | “列出阿拉曼的所有文章” |
| 按主题搜索 | “查找alayman的所有Angular文章” |
| 按主题搜索 | “显示React文章” |
| 有限的结果 | “获取alayman的最新10篇文章” |
| 分页 | “显示文章20-30” |
| 最近的文章 | “alayman.io上的最新文章是什么？” |
直接工具使用
如果你正在构建集成或测试，你也可以直接调用该工具：
// Through MCP client
const result = await client.callTool("fetch-articles", {
search: "TypeScript",
limit: 5
});