MCP Fantasy Library

MCPAI代理

提供方 loickaczmarek

AI代理 未标注 无需鉴权 社区 / 第三方 Claude

一个基于TypeScript的MCP服务器,提供数据库访问工具和资源管理功能,适用于本地数据库操作和LLM集成。

一句话选型结论

按资料字段整理

MCP Fantasy Library 属于AI代理类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

数据库工具本地部署MCP协议TypeScript开发LLM集成本地数据库

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后客户端会列出约 1 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

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

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

多步任务编排

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

自动化重复流程

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

选择建议

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

值得选的地方

  • 资料标注 1 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Fantasy Library当前 1 未标注 未标注 无 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代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方loickaczmarek上游标注的维护方 loickaczmarek
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

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

MCP服务器打字教程

本教程的目的是创建第一个MCP服务器 stdio 在TypeScript中,它提供对本地数据库的访问。

有关MCP协议的更多信息:https://modelcontextprotocol.io/introduction

Prérequis

  • 避免使用javascript
  • Avoir Node.js
  • 拥有Docker

初始化

我们不会开始启动这个项目。为此,我们可以从浏览文件开始 package.json.

我们缺少输入文件 src/index.ts :所以你必须创造它

我们可以启动安装我们选择的软件包的命令。

使用npm: npm install

总理帕斯

我们将添加运行MCP服务器所需的最小值。
为此,在 index.ts,添加以下内容:```javascript
const server = new Server(
{
name: "Fantasy Library Database",
version: "0.1.0",
},
{
capabilities: {
resources: {},
tools: {},
},
},
);

async function runServer() {
const transport = new StdioServerTransport();
console.log("Starting MCP Fantasy Library server")
await server.connect(transport);
}

runServer().catch(console.error);


我们将构建并启动应用程序:

`npm run build && npm run dev`

如果一切顺利,您将看到以下消息:
`Starting MCP Fantasy Library server`

## 一些概念

MCP服务器允许公开工具、资源、提示等。…(见文件 这里 )

在本练习中,我们将重点讨论两个概念:

- 工具:允许您在有或没有参数的情况下执行精确操作。使用是无状态的,用于一次性使用,例如,不需要保持连接活动。这类似于API的精确调用。
- 资源:提供访问权限。使用是有状态的,使用是为了保持连接打开。这类似于API声明。

为了使用MCP服务器,我们将以JSON RPC格式注入JSON,这是MCP协议使用的格式。

## 使用结果

### 设置

我们需要一个数据库,为此,我们将使用 `docker-compose.yml`

枪兵 `docker-compose up -d`

检查数据库是否可通过任何工具访问(工具示例: 海狸)

### 工具的创建

#### 阐述

首先,我们将使服务器的工具可见。
因此,必须添加工具列表查询处理程序。

我们还将借此机会声明我们的第一个工具:检索一本书的描述

在 `index.ts`应添加:```javascript
// au niveau des imports
import {
ListToolsRequestSchema
} from "@modelcontextprotocol/sdk/types.js";

...

// avant de lancer la fonction runServer()
server.setRequestHandler(ListToolsRequestSchema, async () => {
return {
tools: [
{
name: "get-book-description",
description: "Get the book description from fantasy library",
inputSchema: {
type: "object",
properties: {
name: { type: "string" },
},
},
},
],
};
});

启动构建: npm run build

然后,检查它是否与方法一起工作 tools\list :```shell
( cat <<\EOF
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","clientInfo":{"name":"example-client","version":"1.0.0"},"capabilities":{}}}
{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}
EOF
) | npm run dev


在工具列表中,图书恢复工具应在结果中可见。
工具描述很重要:LLM将使用该描述来识别正确的工具!

#### 使用

现在工具已经列出,我们将使用它。

让我们添加以下内容:```javascript
// import
import {
CallToolRequestSchema,
ListToolsRequestSchema
} from &quot;@modelcontextprotocol/sdk/types.js&quot;;

// code
server.setRequestHandler(CallToolRequestSchema, async (request) =&gt; {
if (request.params.name === &quot;get-book-description&quot;) {
return {
content: [{ type: &quot;text&quot;, text: &quot;Hello World !&quot; }],
isError: false,
};
}
throw new Error(`Unknown tool: ${request.params.name}`);
});

构建代码并使用方法启动 tools\call :```shell
( cat <<\EOF
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","clientInfo":{"name":"example-client","version":"1.0.0"},"capabilities":{}}}
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get-book-description", "arguments" : {}}}
EOF
) | npm run dev


如果一切顺利,输出应显示消息“你好,世界!”。

#### 与基地的连接

是时候将服务器连接到数据库了。

为此,我们将添加必要的:

- 传递本地URL的参数
- 连接管理
- 要执行的请求

首先,我们将添加:```javascript
// import
import * as pg from &quot;pg&quot;;

// code
const args = process.argv.slice(2);
if (args.length === 0) {
console.error(&quot;Please provide a database URL as a command-line argument&quot;);
process.exit(1);
}

const databaseUrl = args[0];

const resourceBaseUrl = new URL(databaseUrl);
resourceBaseUrl.protocol = &quot;postgres:&quot;;
resourceBaseUrl.password = &quot;&quot;;

const pool = new pg.Pool({
connectionString: databaseUrl,
});

此部分用于打开与数据库的连接。

此外,让我们创建一个工具将使用的方法:```javascript
async function getBookDescription(request : any) {
const bookName = request.params.arguments?.name as string;

const client = await pool.connect();
try {
await client.query("BEGIN TRANSACTION READ ONLY");
const result = await client.query(SELECT description FROM livres WHERE titre = &#x27;${bookName}&#x27;);
return {
content: [{ type: "text", text: JSON.stringify(result.rows, null, 2) }],
isError: false,
};
} catch (error) {
throw error;
} finally {
client
.query("ROLLBACK")
.catch((error) =>
console.warn("Could not roll back transaction:", error),
);

client.release();
}
}


让我们替换该方法:```javascript
// avant
server.setRequestHandler(CallToolRequestSchema, async (request) =&gt; {
if (request.params.name === &quot;get-book-description&quot;) {
return {
content: [{ type: &quot;text&quot;, text: &quot;Hello World !&quot; }],
isError: false,
};
}
throw new Error(`Unknown tool: ${request.params.name}`);
});

// après
server.setRequestHandler(CallToolRequestSchema, async (request) =&gt; {
if (request.params.name === &quot;get-book-description&quot;) {
return await this.getBookDescription(request);
}
throw new Error(`Unknown tool: ${request.params.name}`);
});

然后,您必须使用该方法进行构建和验证 tools\call :```shell
( cat <<\EOF
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","clientInfo":{"name":"example-client","version":"1.0.0"},"capabilities":{}}}
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get-book-description", "arguments" : {"name":"Culture Code"}}}
EOF
) | npm run dev -- postgresql://admin:password@localhost:5432/bibliotheque


应该会出现文化代码的简要描述!

#### 为了更进一步

添加工具以:

- 可用书籍列表
- 确定借阅给定书籍的人

## 资源利用

#### 阐述

与工具一样,您需要能够识别可用的资源
因此,必须添加资源列表请求处理程序。```javascript
// imports
import {
CallToolRequestSchema,
ListToolsRequestSchema,
ListResourcesRequestSchema
} from &quot;@modelcontextprotocol/sdk/types.js&quot;;

...

// code
const SCHEMA_PATH = &quot;schema&quot;;

server.setRequestHandler(ListResourcesRequestSchema, async () =&gt; {
const client = await pool.connect();
try {
const result = await client.query(
&quot;SELECT table_name FROM information_schema.tables WHERE table_schema = &#x27;public&#x27;&quot;,
);
return {
resources: result.rows.map((row) =&gt; ({
uri: new URL(`${row.table_name}/${SCHEMA_PATH}`, resourceBaseUrl).href,
mimeType: &quot;application/json&quot;,
name: `&quot;${row.table_name}&quot; database schema`,
})),
};
} finally {
client.release();
}
});

启动构建: npm run build

然后,检查它是否有效,我们将使用方法进行查询 resources/list :```shell
( cat <<\EOF
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","clientInfo":{"name":"example-client","version":"1.0.0"},"capabilities":{}}}
{"jsonrpc":"2.0","id":2,"method":"resources/list","params":{}}
EOF
) | npm run dev -- postgresql://admin:password@localhost:5432/bibliotheque


#### 使用

我们将添加资源使用处理程序:```javascript
// import
import {
CallToolRequestSchema,
ListResourcesRequestSchema,
ListToolsRequestSchema,
ReadResourceRequestSchema,
} from &quot;@modelcontextprotocol/sdk/types.js&quot;;

// code
server.setRequestHandler(ReadResourceRequestSchema, async (request) =&gt; {
const resourceUrl = new URL(request.params.uri);

const pathComponents = resourceUrl.pathname.split(&quot;/&quot;);
const schema = pathComponents.pop();
const tableName = pathComponents.pop();

if (schema !== SCHEMA_PATH) {
throw new Error(&quot;Invalid resource URI&quot;);
}

const client = await pool.connect();
try {
const result = await client.query(
&quot;SELECT column_name, data_type FROM information_schema.columns WHERE table_name = $1&quot;,
[tableName],
);

return {
contents: [
{
uri: request.params.uri,
mimeType: &quot;application/json&quot;,
text: JSON.stringify(result.rows, null, 2),
},
],
};
} finally {
client.release();
}
});

让我们启动构建,检查它是否与方法一起工作 resources/read :shell ( cat &lt;&lt;\EOF {&quot;jsonrpc&quot;:&quot;2.0&quot;,&quot;id&quot;:1,&quot;method&quot;:&quot;initialize&quot;,&quot;params&quot;:{&quot;protocolVersion&quot;:&quot;2024-11-05&quot;,&quot;clientInfo&quot;:{&quot;name&quot;:&quot;example-client&quot;,&quot;version&quot;:&quot;1.0.0&quot;},&quot;capabilities&quot;:{}}} {&quot;jsonrpc&quot;:&quot;2.0&quot;,&quot;id&quot;:2,&quot;method&quot;:&quot;resources/read&quot;,&quot;params&quot;:{&quot;uri&quot;:&quot;postgres://admin@localhost:5432/clients/schema&quot;}} EOF ) | npm run dev -- postgresql://admin:password@localhost:5432/bibliotheque

结果应该是数据库的模式信息

为了更进一步

本教程基于Postgres MCP服务器( 这里 )

要在实际条件下测试它,最好将其插入MCP客户端。
列表在这里:https://modelcontextprotocol.io/clients

该服务器已使用Claude Code客户端进行了测试和验证,并返回了令人满意的结果,如 donnes moi la description du livre Culture Code

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
MCP Fantasy Library 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCP Fantasy Library 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Fantasy Library 收费吗?

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

MCP Fantasy Library 需要 API Key 吗?

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

MCP Fantasy Library 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Fantasy Library 能提供哪些能力?

资料显示约 1 个工具;能力标签包括 数据库工具、TypeScript开发、Claude、模型集成。具体工具清单以官方文档为准。

热门专题

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

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